mirror of
https://github.com/torvalds/linux.git
synced 2026-05-12 16:18:45 +02:00
81cd25d263
Introduce the user-space interface for the Live Update Orchestrator via ioctl commands, enabling external control over the live update process and management of preserved resources. The idea is that there is going to be a single userspace agent driving the live update, therefore, only a single process can ever hold this device opened at a time. The following ioctl commands are introduced: LIVEUPDATE_IOCTL_CREATE_SESSION Provides a way for userspace to create a named session for grouping file descriptors that need to be preserved. It returns a new file descriptor representing the session. LIVEUPDATE_IOCTL_RETRIEVE_SESSION Allows the userspace agent in the new kernel to reclaim a preserved session by its name, receiving a new file descriptor to manage the restored resources. Link: https://lkml.kernel.org/r/20251125165850.3389713-6-pasha.tatashin@soleen.com Signed-off-by: Pasha Tatashin <pasha.tatashin@soleen.com> Reviewed-by: Mike Rapoport (Microsoft) <rppt@kernel.org> Reviewed-by: Pratyush Yadav <pratyush@kernel.org> Tested-by: David Matlack <dmatlack@google.com> Cc: Aleksander Lobakin <aleksander.lobakin@intel.com> Cc: Alexander Graf <graf@amazon.com> Cc: Alice Ryhl <aliceryhl@google.com> Cc: Andriy Shevchenko <andriy.shevchenko@linux.intel.com> Cc: anish kumar <yesanishhere@gmail.com> Cc: Anna Schumaker <anna.schumaker@oracle.com> Cc: Bartosz Golaszewski <bartosz.golaszewski@linaro.org> Cc: Bjorn Helgaas <bhelgaas@google.com> Cc: Borislav Betkov <bp@alien8.de> Cc: Chanwoo Choi <cw00.choi@samsung.com> Cc: Chen Ridong <chenridong@huawei.com> Cc: Chris Li <chrisl@kernel.org> Cc: Christian Brauner <brauner@kernel.org> Cc: Daniel Wagner <wagi@kernel.org> Cc: Danilo Krummrich <dakr@kernel.org> Cc: Dan Williams <dan.j.williams@intel.com> Cc: David Hildenbrand <david@redhat.com> Cc: David Jeffery <djeffery@redhat.com> Cc: David Rientjes <rientjes@google.com> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Cc: Guixin Liu <kanie@linux.alibaba.com> Cc: "H. Peter Anvin" <hpa@zytor.com> Cc: Hugh Dickins <hughd@google.com> Cc: Ilpo Järvinen <ilpo.jarvinen@linux.intel.com> Cc: Ingo Molnar <mingo@redhat.com> Cc: Ira Weiny <ira.weiny@intel.com> Cc: Jann Horn <jannh@google.com> Cc: Jason Gunthorpe <jgg@nvidia.com> Cc: Jens Axboe <axboe@kernel.dk> Cc: Joanthan Cameron <Jonathan.Cameron@huawei.com> Cc: Joel Granados <joel.granados@kernel.org> Cc: Johannes Weiner <hannes@cmpxchg.org> Cc: Jonathan Corbet <corbet@lwn.net> Cc: Lennart Poettering <lennart@poettering.net> Cc: Leon Romanovsky <leon@kernel.org> Cc: Leon Romanovsky <leonro@nvidia.com> Cc: Lukas Wunner <lukas@wunner.de> Cc: Marc Rutland <mark.rutland@arm.com> Cc: Masahiro Yamada <masahiroy@kernel.org> Cc: Matthew Maurer <mmaurer@google.com> Cc: Miguel Ojeda <ojeda@kernel.org> Cc: Myugnjoo Ham <myungjoo.ham@samsung.com> Cc: Parav Pandit <parav@nvidia.com> Cc: Pratyush Yadav <ptyadav@amazon.de> Cc: Randy Dunlap <rdunlap@infradead.org> Cc: Roman Gushchin <roman.gushchin@linux.dev> Cc: Saeed Mahameed <saeedm@nvidia.com> Cc: Samiullah Khawaja <skhawaja@google.com> Cc: Song Liu <song@kernel.org> Cc: Steven Rostedt <rostedt@goodmis.org> Cc: Stuart Hayes <stuart.w.hayes@gmail.com> Cc: Tejun Heo <tj@kernel.org> Cc: Thomas Gleinxer <tglx@linutronix.de> Cc: Thomas Weißschuh <linux@weissschuh.net> Cc: Vincent Guittot <vincent.guittot@linaro.org> Cc: William Tu <witu@nvidia.com> Cc: Yoann Congal <yoann.congal@smile.fr> Cc: Zhu Yanjun <yanjun.zhu@linux.dev> Cc: Zijun Hu <quic_zijuhu@quicinc.com> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
73 lines
2.1 KiB
C
73 lines
2.1 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
|
|
/*
|
|
* Copyright (c) 2025, Google LLC.
|
|
* Pasha Tatashin <pasha.tatashin@soleen.com>
|
|
*/
|
|
|
|
#ifndef _LINUX_LUO_INTERNAL_H
|
|
#define _LINUX_LUO_INTERNAL_H
|
|
|
|
#include <linux/liveupdate.h>
|
|
#include <linux/uaccess.h>
|
|
|
|
struct luo_ucmd {
|
|
void __user *ubuffer;
|
|
u32 user_size;
|
|
void *cmd;
|
|
};
|
|
|
|
static inline int luo_ucmd_respond(struct luo_ucmd *ucmd,
|
|
size_t kernel_cmd_size)
|
|
{
|
|
/*
|
|
* Copy the minimum of what the user provided and what we actually
|
|
* have.
|
|
*/
|
|
if (copy_to_user(ucmd->ubuffer, ucmd->cmd,
|
|
min_t(size_t, ucmd->user_size, kernel_cmd_size))) {
|
|
return -EFAULT;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
/*
|
|
* Handles a deserialization failure: devices and memory is in unpredictable
|
|
* state.
|
|
*
|
|
* Continuing the boot process after a failure is dangerous because it could
|
|
* lead to leaks of private data.
|
|
*/
|
|
#define luo_restore_fail(__fmt, ...) panic(__fmt, ##__VA_ARGS__)
|
|
|
|
/**
|
|
* struct luo_session - Represents an active or incoming Live Update session.
|
|
* @name: A unique name for this session, used for identification and
|
|
* retrieval.
|
|
* @ser: Pointer to the serialized data for this session.
|
|
* @list: A list_head member used to link this session into a global list
|
|
* of either outgoing (to be preserved) or incoming (restored from
|
|
* previous kernel) sessions.
|
|
* @retrieved: A boolean flag indicating whether this session has been
|
|
* retrieved by a consumer in the new kernel.
|
|
* @mutex: protects fields in the luo_session.
|
|
*/
|
|
struct luo_session {
|
|
char name[LIVEUPDATE_SESSION_NAME_LENGTH];
|
|
struct luo_session_ser *ser;
|
|
struct list_head list;
|
|
bool retrieved;
|
|
struct mutex mutex;
|
|
};
|
|
|
|
int luo_session_create(const char *name, struct file **filep);
|
|
int luo_session_retrieve(const char *name, struct file **filep);
|
|
int __init luo_session_setup_outgoing(void *fdt);
|
|
int __init luo_session_setup_incoming(void *fdt);
|
|
int luo_session_serialize(void);
|
|
int luo_session_deserialize(void);
|
|
bool luo_session_quiesce(void);
|
|
void luo_session_resume(void);
|
|
|
|
#endif /* _LINUX_LUO_INTERNAL_H */
|