From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2E40EEB64D9 for ; Tue, 4 Jul 2023 21:16:56 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id C02EA2800BB; Tue, 4 Jul 2023 17:16:55 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id BB29D2800B2; Tue, 4 Jul 2023 17:16:55 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id A543A2800BB; Tue, 4 Jul 2023 17:16:55 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id 93F432800B2 for ; Tue, 4 Jul 2023 17:16:55 -0400 (EDT) Received: from smtpin04.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id 647D4AFEEF for ; Tue, 4 Jul 2023 21:16:55 +0000 (UTC) X-FDA: 80975189190.04.3AE2AC6 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by imf04.hostedemail.com (Postfix) with ESMTP id 48E2C40005 for ; Tue, 4 Jul 2023 21:16:53 +0000 (UTC) Authentication-Results: imf04.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=LDOmEEyx; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf04.hostedemail.com: domain of peterx@redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=peterx@redhat.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1688505413; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=VV04n37U8nBXKx7jlfEZg7R8H9gfvZ1yfEmW1FTRWAc=; b=GEjRTzw2jKxU53nTuXvMdhA5QmPdqdfF//2aBvL8HjYYb83HmjCxUXe0UsvSfDO6gUJIxM LOQLAtEOlvWdNun0BK4HS19ZJyX2Wc2PlypjCWHKL3gvnnelch1Nl9UGAETXUPQToOOClH /bML8WsHQ2E++b0u0DMrEEyqlyc23dI= ARC-Authentication-Results: i=1; imf04.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b=LDOmEEyx; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf04.hostedemail.com: domain of peterx@redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=peterx@redhat.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1688505413; a=rsa-sha256; cv=none; b=vLCeuP8IXv7RHD9dXBcdkq5gJWTw/5FzEVmOOiPBGr9bqUTWB87oa2YR5Dlg9uCDfy2qY1 P4n+VGt+04xi82ccR5wXL6sv9FCqWW5+g6wXssIbKnMEQWds4pEdiMypB7XFy6nJ+sQAJu bFP+xuAAAWSUum0Odr8CYrOfoiSxa3o= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1688505412; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=VV04n37U8nBXKx7jlfEZg7R8H9gfvZ1yfEmW1FTRWAc=; b=LDOmEEyxrmHT8Ccjq6ljx8l6JikH5iba0NFkW4DXzZm2iwyDN7r9WzkvQMDyYZV9Fp18tO pJYKNwL8T6oxnJv8CVJ7uN19vYt1ttOLA4F+Pejvqlv7K9bfo1DVeTby0lnjt7h0RlTGDA jkd2hfi4iLP2Gv2YBbarurcI+aFD33s= Received: from mail-qk1-f198.google.com (mail-qk1-f198.google.com [209.85.222.198]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-150-hEQ4N6e8MrCfl-3jsckeRg-1; Tue, 04 Jul 2023 17:16:51 -0400 X-MC-Unique: hEQ4N6e8MrCfl-3jsckeRg-1 Received: by mail-qk1-f198.google.com with SMTP id af79cd13be357-765ad67e600so108135585a.0 for ; Tue, 04 Jul 2023 14:16:51 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1688505410; x=1691097410; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=VV04n37U8nBXKx7jlfEZg7R8H9gfvZ1yfEmW1FTRWAc=; b=XBqRZ/0KE0Nya9/wPi1pC3VSxF8tYX0jXX1i0pe2hQN+n7vdpB8BatCnpVQwRzTPRY MgGJVClmy42r+6Q0coH5iuX/qGID4ZHEVXSj2VtxFxHFYj6CxqAmF+0Ngz4PX+TQmJn9 b/7VOArgCXCLLm6yOtw0InWIzj9B9vETCDB99o7KntbuayF7NufdtWgpyLFTmkA+u+vX FA/p6c68jyTnNuGuRkKbNc4xP0WV3MJ/DQjv6xuLF30n8sidPuwDFXgFigTvCDQo8Fwm ctnCWBuftAS8LbOnT6mJUn3zup2mi6kx/otAnjePel+fdZntQUZCZl531s89NakTWoBt aswg== X-Gm-Message-State: AC+VfDwFFrXchEzCLiEjYskK8iXuPvmYvXA59/k0LzEQcV7lGhFu2FoZ qRkc14X14octn5BYdM7A2wgkRieJ8FOI6V7i0HkXyr886rU81hECBWDehXyaQ3cCdODJgsTSjZ/ 1/G/Bzj7TAgs= X-Received: by 2002:a05:620a:4487:b0:765:435c:a4fa with SMTP id x7-20020a05620a448700b00765435ca4famr20273154qkp.0.1688505410588; Tue, 04 Jul 2023 14:16:50 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ4h9qxm2qr2McyrSm55+RKE46g3KUdAtCtYdQn6fLq1MJrI38m4oaSBNE07KxZKvdH+XrvoEw== X-Received: by 2002:a05:620a:4487:b0:765:435c:a4fa with SMTP id x7-20020a05620a448700b00765435ca4famr20273141qkp.0.1688505410353; Tue, 04 Jul 2023 14:16:50 -0700 (PDT) Received: from x1n (cpe5c7695f3aee0-cm5c7695f3aede.cpe.net.cable.rogers.com. [99.254.144.39]) by smtp.gmail.com with ESMTPSA id i4-20020a05620a144400b0076728319575sm6994582qkl.27.2023.07.04.14.16.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 04 Jul 2023 14:16:50 -0700 (PDT) Date: Tue, 4 Jul 2023 17:16:48 -0400 From: Peter Xu To: Axel Rasmussen Cc: Alexander Viro , Andrew Morton , Christian Brauner , David Hildenbrand , Huang Ying , Hugh Dickins , James Houghton , Jiaqi Yan , Jonathan Corbet , "Liam R. Howlett" , Miaohe Lin , Mike Kravetz , "Mike Rapoport (IBM)" , Muchun Song , Nadav Amit , Naoya Horiguchi , Shuah Khan , ZhangPeng , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-mm@kvack.org, linux-kselftest@vger.kernel.org Subject: Re: [PATCH v2 6/6] mm: userfaultfd: add basic documentation for UFFDIO_POISON Message-ID: References: <20230629205040.665834-1-axelrasmussen@google.com> <20230629205040.665834-6-axelrasmussen@google.com> MIME-Version: 1.0 In-Reply-To: <20230629205040.665834-6-axelrasmussen@google.com> X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset=utf-8 Content-Disposition: inline X-Rspam-User: X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: 48E2C40005 X-Stat-Signature: etgodxq1gsdzm1cefmor8xbomfhgkqry X-HE-Tag: 1688505413-39792 X-HE-Meta: U2FsdGVkX18KwTsoGqQHQETZ4dc0kJqqThLzHp9++h0SvNkbjn5Na2IZnGL6MzhUjM/enDUiDuEVtgjcN1TyRDF2+p3N6+rJU6Xy+DsBIaXcZ0a9UCU0kuVRWal5GGLBHmxWoRlwV6uWmcACv6LjM+2+2iGUfS0PQKnQLRQxiUfGVHjf6DL++AGYyvislx1gKuN0ktyGyTJp+1sWo20gG7EEDfOAfTcYY8KvbySl6mWQBghknDuBI5oylgg8ekSCZnORqaQ2ox0nAlSg0AYJe5cgS+n9OeNFADV5HTYVGVB5vIhg/RVFvdBqONbLrl72nz1X6psXQL0VGinXDHYE+JC3pmlnEPbZnWEldAYDGPfRfalJrR8FIvR0m789SLn8my52k52+kT70ME1eGmv/lmjTjtDljmLYIqxLnsn9tYAnx+0CCvS3ARLTPXaciGSe+G6yGeeW5HR8Y2h1NjqxOpJDGG/aMmzE0TXTTntTuunXhmMXPg+yW4+okEehAWrQdeJ+c/nH8URC4bK494ayQwvniRTDQeM+ijU9mAOd8XTOhXzsGA4+4NGeNLsa+4HOshh+LRgjUYasAngCOkw7NBcISYpt1LVtnVIKLdmqNemRZR2Ax/HfzrNVaoBv6ByqlZDVzomTcVOHDvjayAdQIhDK+KGqb/bDZHiytsxRRoYPfdpSAyRhfW3qYRVmY/b81cR/0EOr5svzXf+U3z6b9y5bg+oWya6EgUdYxTrxetNzHld756lkKOiod9bmEMveVZEy6CahmwY1EPx+b7+FeGqNGLxWOIsO13YrAG2u1awIOe5ZGbos1hcSxv8jXO85P9pigcaqF8thKe58W0/RUzEmtMdbkNu71+nO4MlJGi8udnO+Rd7wh5SBnaZPyZFDjN3TFyKKMljlN/1VluGFRBkn6CorsQleefbnaVyyEj4c7WSGhJ8ajWq5CDv61xs2y4c/mgdtyI032pi57TC cVu1rZhp MP5NNb7Xk1LE06/dR96cvgkd3leU7rkU3G9gI0pNLcIl0sgDR205bl9y5cEX9sVaz4fTDpnbIS2CzEa7suIlGp25sECCwI04AGT22GVv3wjplSZztLFpE8ESXTlH2kPuw6UEqzq39L7tjWIiskAD2GNOFF4QqEkCgyaXVz9PApGnUf1UlUd97bygKupIFDRaofZ0psxFLuFgxP9j0SRkh3WtXn9eJsHpMiw8WeBGussnixbt3gcWDIhnKCR48LU+K5xeVHSNfR414jHBsqFCaeVUNWgyoY4H+ld7+Z1JRul2oi7/nFhyjnmfZyJlAkTHVbIAUs/UvuHB15jfQFgR/4B3Yf0qedxZt6RAWGcvi9rSZeLeQ8dG70xqmA22xO0ZWS5iwS93QMkDfnBOz85+LHhUj44Np4O1gpkixNtbF/ZT+WMuORXtm+0jEvepNYF+KIc3qYDJEVEY8eyo= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: On Thu, Jun 29, 2023 at 01:50:40PM -0700, Axel Rasmussen wrote: > Just describe the feature at a really basic level. > > Signed-off-by: Axel Rasmussen The final enablement of the feature can be squashed into this doc update patch too. Acked-by: Peter Xu > --- > Documentation/admin-guide/mm/userfaultfd.rst | 15 +++++++++++++++ > 1 file changed, 15 insertions(+) > > diff --git a/Documentation/admin-guide/mm/userfaultfd.rst b/Documentation/admin-guide/mm/userfaultfd.rst > index 7c304e432205..b19053436369 100644 > --- a/Documentation/admin-guide/mm/userfaultfd.rst > +++ b/Documentation/admin-guide/mm/userfaultfd.rst > @@ -244,6 +244,21 @@ write-protected (so future writes will also result in a WP fault). These ioctls > support a mode flag (``UFFDIO_COPY_MODE_WP`` or ``UFFDIO_CONTINUE_MODE_WP`` > respectively) to configure the mapping this way. > > +Memory Poisioning Emulation > +--------------------------- > + > +In response to a fault (either missing or minor), an action userspace can > +take to "resolve" it is to issue a ``UFFDIO_POISON``. This will cause any > +future faulters to either get a SIGBUS, or in KVM's case the guest will > +receive an MCE as if there were hardware memory poisoning. > + > +This is used to emulate hardware memory poisoning. Imagine a VM running on a > +machine which experiences a real hardware memory error. Later, we live migrate > +the VM to another physical machine. Since we want the migration to be > +transparent to the guest, we want that same address range to act as if it was > +still poisoned, even though it's on a new physical host which ostentisbly > +doesn't have a memory error in the exact same spot. > + > QEMU/KVM > ======== > > -- > 2.41.0.255.g8b1d071c50-goog > -- Peter Xu