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 DE449C2D0CD for ; Thu, 15 May 2025 18:24:17 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 2C93C8D000A; Thu, 15 May 2025 14:23:50 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 27DCA8D0001; Thu, 15 May 2025 14:23:50 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 05B938D000A; Thu, 15 May 2025 14:23:49 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id D65EC8D0001 for ; Thu, 15 May 2025 14:23:49 -0400 (EDT) Received: from smtpin30.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id DF6F8B9B6F for ; Thu, 15 May 2025 18:23:50 +0000 (UTC) X-FDA: 83445965820.30.12364C3 Received: from mail-qk1-f180.google.com (mail-qk1-f180.google.com [209.85.222.180]) by imf19.hostedemail.com (Postfix) with ESMTP id 104C91A000C for ; Thu, 15 May 2025 18:23:48 +0000 (UTC) Authentication-Results: imf19.hostedemail.com; dkim=pass header.d=soleen-com.20230601.gappssmtp.com header.s=20230601 header.b=utD4EwTt; dmarc=pass (policy=none) header.from=soleen.com; spf=pass (imf19.hostedemail.com: domain of pasha.tatashin@soleen.com designates 209.85.222.180 as permitted sender) smtp.mailfrom=pasha.tatashin@soleen.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1747333429; a=rsa-sha256; cv=none; b=F/Uf6FYXs6P5tFYVAxeqhES7RAU3m8rRXkqgSfMfje3GtLlIB9WwAywrdACqlhGgROP3Mh vlRAx3OviMlP4q1mUs1tALotYCMn0pVU3LNQed9WgeGwIj46W5JbrMC7o4XFS9P6nVufa3 b0Q1j/nk8aJdS11luDOsDdwx+IHi5GI= ARC-Authentication-Results: i=1; imf19.hostedemail.com; dkim=pass header.d=soleen-com.20230601.gappssmtp.com header.s=20230601 header.b=utD4EwTt; dmarc=pass (policy=none) header.from=soleen.com; spf=pass (imf19.hostedemail.com: domain of pasha.tatashin@soleen.com designates 209.85.222.180 as permitted sender) smtp.mailfrom=pasha.tatashin@soleen.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1747333429; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=P6KJXTjc0r76p8v9NLIxG+1plF/W6x+7amHEacWowEk=; b=PWjpcWpZVY5qC+jUVjwzkRUo9qwyGOWZb1G+PRvSUJSc3aJ+kXZ5NH9G82CD3zeH9rMiUK wK1oOPZON2xfWlKXazC7c+bWWKF0PjHRL4fhsq5nCKMy+Ll6eI6E2fLzmwlZpXhGFogP6W Qlw+c1tEet2u+fW6cIQcORdm0fcto0g= Received: by mail-qk1-f180.google.com with SMTP id af79cd13be357-7c96759d9dfso175720385a.3 for ; Thu, 15 May 2025 11:23:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=soleen-com.20230601.gappssmtp.com; s=20230601; t=1747333428; x=1747938228; darn=kvack.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=P6KJXTjc0r76p8v9NLIxG+1plF/W6x+7amHEacWowEk=; b=utD4EwTtGiRjb4iM19/I3SJUHloffza6wfqS/SfztGurN5ijmUmR+9l+9v7YBXlk0B PEzpcvdgqEV+r+qL5NX/iPWXZVLUN/qr4oc0V2D+Q4j2fVls/dKGu6XJrWhCzzhNMgkd rk7+5SR9j1Rrv4OQCb4KFqe+x1kt87b0ZeHmlF+e07gBxHoDRMl1iSlYlVjpDKYSAd6L oHBlu/3Rm92SykKJZvTn961v8Ol6WDw1wjbRUl607It7T3mc85oPx5lnndgl1kDEvg4e cgDw1a/Czh6NI6Tc9vk4xn9noCEHeAxarsh9OWs/fiwpO9c8SLTa8yFThuQiYZ9WBFfn uhoQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1747333428; x=1747938228; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=P6KJXTjc0r76p8v9NLIxG+1plF/W6x+7amHEacWowEk=; b=C1gZp6hw2AGVSYkJQQ8iZREj4tmOQxcSN4gFOZ8I8q4hL3JjMzBaiptBqxnDsbd7Py VKrV9JQFlywKAVxg+pSHQKrsJkeZ9k6z1M9qRtoyp79acmwSfD0FB49IEZX42l59tVv5 /4us0vzRqY2ObVEnkFZ2x8U+60ENBb+LShh5nLl5xPT9kJ4P0IFRrRZ9RieQpI8birAJ XeHwiGVeqqNHXqe9H6phzIM78d2QdbU0sdJfU8/GCzBtsUuCoeq9cmbgSzuoW99PegS3 r63s2byqIlhUEkJ3yFCqTh88goscpFqKqoDMWUjdqc9JkRpyTlJu1tEKHC6rZ/eDEGqB BMZQ== X-Forwarded-Encrypted: i=1; AJvYcCXsOJbIgUSimDLCoKtrPuxWPROqfKE4TiV4rywIJaHDsi3H1Rwa58s/J5SV5zD9M22QCBD1Va27+w==@kvack.org X-Gm-Message-State: AOJu0YyIsWs9yt1RkUtat8Ohi6Li8uvVs3iZhUmVENpx3fvjRdXiE15E Lg9RPWrJyUQr4EW9Eaz1PCeyekIRfD3Sh3MeEnvsB4q+JsQmjkwCwjaZkSo0Sl7sZBA= X-Gm-Gg: ASbGncuL5Kc3rvE3elcESoL//zp0mkOw6g32MqGNYtoDjQw6S8QX43RJa54cxj1xWWP YjLWCQsamzh6JSZ12YcmsbJUnOQ+/rsOcYiU3owZnv/kN/Ow4Fjc75WVRjVy5uET9+gTRalsbG2 TKlvFmOcmMzy5hSo8oDyDA+Z7tJZajN8dDM4b0TUKs6p9/TYL27z/F+/IKG6Pd4QnMlLg4dY9ak Wo3xYdtq28YFhrAyZkRJEKmz82/cvZGAyHRYcj8qbUlQGzvBXnBGXjWNrmIUBahnCvG0zrgYGUU 8C2JcqhWVA7kG3R7CPT+rxBVF4mmANAipEsv9ujUAvetkGBXMfeqTWXCX0FvDMwuJPY/AirZ1/t WmdZNRzTk/bEr/cn1/EVFbIathC4VhxZB6jLdo+V0vLin X-Google-Smtp-Source: AGHT+IEG7RwmXqR/Tm2fInhaZBiu3WtaiEVf8X1895Z0lbevuSTfErYi54kRZ9n6luWpwWWeTV+CYQ== X-Received: by 2002:a05:620a:d89:b0:7c5:4b24:468d with SMTP id af79cd13be357-7cd46707195mr63632785a.2.1747333428187; Thu, 15 May 2025 11:23:48 -0700 (PDT) Received: from soleen.c.googlers.com.com (138.200.150.34.bc.googleusercontent.com. [34.150.200.138]) by smtp.gmail.com with ESMTPSA id af79cd13be357-7cd466fc2afsm18218685a.0.2025.05.15.11.23.47 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 15 May 2025 11:23:47 -0700 (PDT) From: Pasha Tatashin To: pratyush@kernel.org, jasonmiu@google.com, graf@amazon.com, changyuanl@google.com, pasha.tatashin@soleen.com, rppt@kernel.org, dmatlack@google.com, rientjes@google.com, corbet@lwn.net, rdunlap@infradead.org, ilpo.jarvinen@linux.intel.com, kanie@linux.alibaba.com, ojeda@kernel.org, aliceryhl@google.com, masahiroy@kernel.org, akpm@linux-foundation.org, tj@kernel.org, yoann.congal@smile.fr, mmaurer@google.com, roman.gushchin@linux.dev, chenridong@huawei.com, axboe@kernel.dk, mark.rutland@arm.com, jannh@google.com, vincent.guittot@linaro.org, hannes@cmpxchg.org, dan.j.williams@intel.com, david@redhat.com, joel.granados@kernel.org, rostedt@goodmis.org, anna.schumaker@oracle.com, song@kernel.org, zhangguopeng@kylinos.cn, linux@weissschuh.net, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-mm@kvack.org, gregkh@linuxfoundation.org, tglx@linutronix.de, mingo@redhat.com, bp@alien8.de, dave.hansen@linux.intel.com, x86@kernel.org, hpa@zytor.com, rafael@kernel.org, dakr@kernel.org, bartosz.golaszewski@linaro.org, cw00.choi@samsung.com, myungjoo.ham@samsung.com, yesanishhere@gmail.com, Jonathan.Cameron@huawei.com, quic_zijuhu@quicinc.com, aleksander.lobakin@intel.com, ira.weiny@intel.com, andriy.shevchenko@linux.intel.com, leon@kernel.org, lukas@wunner.de, bhelgaas@google.com, wagi@kernel.org, djeffery@redhat.com, stuart.w.hayes@gmail.com, ptyadav@amazon.de Subject: [RFC v2 15/16] docs: add luo documentation Date: Thu, 15 May 2025 18:23:19 +0000 Message-ID: <20250515182322.117840-16-pasha.tatashin@soleen.com> X-Mailer: git-send-email 2.49.0.1101.gccaa498523-goog In-Reply-To: <20250515182322.117840-1-pasha.tatashin@soleen.com> References: <20250515182322.117840-1-pasha.tatashin@soleen.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Stat-Signature: g7ueq57jan8peww6w64xdi8bu3qgqut7 X-Rspam-User: X-Rspamd-Queue-Id: 104C91A000C X-Rspamd-Server: rspam06 X-HE-Tag: 1747333428-924426 X-HE-Meta: U2FsdGVkX1/bJX/vz5ygphYyqBeSL+3w1ofdBclnm/RY2urL2TmsCeTeYa7DB/9qfH4VPnc6S/JlGkx5GvK0qGsdo38Kiu/3h5dAny1W/kNCrHVEBWwYS9Lo5FL3SFB0WXYC2c/7pZ8QikB7EYE5x9iMU9+fuz8BQ9C93t43Ykz/Butrl07QYnCmFmBWl0wVaAm0jp/3RtlqYDNEPWE/Xdll5eNSHh+XIn/9EBkB9iRFO34HXdagCSBxJRaw8XQoMRYSOWbCa4cuLQQCH84YnUg94IVZ+MTl6vSyS/XneMy87aUibS8eLXljPGBTNsTWlpMOVXAc6T80XN8MKoOf0xNIDTop4r7OaPbE8qoGfrxu/k2+wKKhqIU1cKo/JQfKAgg2lIzIaTTWDOXzH+4O/TMFxeYpbdyWazqT0JADfgDPXnk+7fl1N+9Ot6cP6U96lBXWbYP14oc7IPW5BOABB8c12MvlmDxzHqfRC+hs/auU+JZfdbNMZsF7IImFEEGUtfPnITT8f+7ChCSuho1+oyKR5FfK4D6SOaziATYUsRCB1N+Q1WGL8YSRS1wE4Mk+LANxqcIvK5fWc2uMe3t92Ko0n5LvvrI9NcNJJl1pCgAIQAvYnV/Go6G93oHc52LI1Br2MBKE9OZa+QEU4nlH/BjyQyL/1p2sxZdP0QgHu2bkaYE5ANHroT/x9iUSIPB4O4uaumGvmH7FAqJPDGp3Dd1ZNSlg5vX/k4UIYnzIbcwux0EbQ5NWJuoig4eRQKCdHOu3Csyznc31EF5rZ1pak+NdE0TAv6C9XnAOf8uYJKeekXgFkgXlReEl7FShHnjd3pDi2uK8zN/y/Pvk31MO9fELG7hiOVtY0mjzO3/SBuFD1sCMc/VQoQWBjfQlUMUoey7Az1I8bh8MTFeyDtmL3cvEZjAyMTtqXnCxmio6gw9HRqBUuW9byd6QLYVR23813y1oy/dXCKWEvUuhXh/ aIEjC17y qHWnuCZLNbQDead48+GbssH3EDVnIN1yIWaltbg7xFRFM9uY51n9oT2w2gCuLYpoLD15GdN/LXB8yj+ZApmRcRlCzzfJmuX6hmvMKAY9NP/Um6zDRz+DNNkQx85G3Itn5mlcAVQ4aXwOP0TBQ39xroeg0K0dQF5XFBXJcO6v36xsGDLzI8+GHKDeXL7jxCQPdme5743boKPDI7l2g17is9HwVQJbt3T+soJAX6GTF7LxddG6DXOhajB08d6gXG45+1+KWAiRfQ16N3rFQ6DzlK9OBc3wpRPVbM0iQ4tuyourGWapcVSdpNZ/Y7tKzCxr8yDxvKQsoMwnCu2nmT7xbbc+1SV9gxxtKaCcO3R0JK5SdTslGByFdrYUO0PGELPvZrll6zdSRgUl5jGIGViOAn9aCt1DkPe9ujdXPYd0LbCscwWJHUUjvPmiEdDcjopO5/bNMXw225qa+rtk= 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: List-Subscribe: List-Unsubscribe: Add the main documentation file for the Live Update Orchestrator subsystem at Documentation/admin-guide/liveupdate.rst. The new file is included in the main Documentation/admin-guide/index.rst table of contents. Signed-off-by: Pasha Tatashin --- Documentation/admin-guide/index.rst | 1 + Documentation/admin-guide/liveupdate.rst | 62 ++++++++++++++++++++++++ 2 files changed, 63 insertions(+) create mode 100644 Documentation/admin-guide/liveupdate.rst diff --git a/Documentation/admin-guide/index.rst b/Documentation/admin-guide/index.rst index 259d79fbeb94..3f59ccf32760 100644 --- a/Documentation/admin-guide/index.rst +++ b/Documentation/admin-guide/index.rst @@ -95,6 +95,7 @@ likely to be of interest on almost any system. cgroup-v2 cgroup-v1/index cpu-load + liveupdate mm/index module-signing namespaces/index diff --git a/Documentation/admin-guide/liveupdate.rst b/Documentation/admin-guide/liveupdate.rst new file mode 100644 index 000000000000..bff9475d2518 --- /dev/null +++ b/Documentation/admin-guide/liveupdate.rst @@ -0,0 +1,62 @@ +.. SPDX-License-Identifier: GPL-2.0 + +============================== +Live Update Orchestrator (LUO) +============================== +:Author: Pasha Tatashin + +.. kernel-doc:: drivers/misc/liveupdate/luo_core.c + :doc: Live Update Orchestrator (LUO) + +LUO Subsystems Participation +============================ +.. kernel-doc:: drivers/misc/liveupdate/luo_subsystems.c + :doc: LUO Subsystems support + +LUO Preserving File Descriptors +=============================== +.. kernel-doc:: drivers/misc/liveupdate/luo_files.c + :doc: LUO file descriptors + +LUO ioctl interface +=================== +.. kernel-doc:: drivers/misc/liveupdate/luo_ioctl.c + :doc: LUO ioctl Interface + +LUO sysfs interface +=================== +.. kernel-doc:: drivers/misc/liveupdate/luo_sysfs.c + :doc: LUO sysfs interface + +LUO selftests ioctl +=================== +.. kernel-doc:: drivers/misc/liveupdate/luo_selftests.c + :doc: LUO Selftests + +ioctl uAPI +=========== +.. kernel-doc:: include/uapi/linux/liveupdate.h + +Public API +========== +.. kernel-doc:: include/linux/liveupdate.h + +.. kernel-doc:: drivers/misc/liveupdate/luo_core.c + :export: + +.. kernel-doc:: drivers/misc/liveupdate/luo_subsystems.c + :export: + +.. kernel-doc:: drivers/misc/liveupdate/luo_files.c + :export: + +Internal API +============ +.. kernel-doc:: drivers/misc/liveupdate/luo_core.c + :internal: + +.. kernel-doc:: drivers/misc/liveupdate/luo_subsystems.c + :internal: + +.. kernel-doc:: drivers/misc/liveupdate/luo_files.c + :internal: -- 2.49.0.1101.gccaa498523-goog