linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root
@ 2021-05-28 14:37 menglong8.dong
  2021-05-28 14:38 ` [PATCH v3 1/3] init/main.c: introduce function ramdisk_exec_exist() menglong8.dong
                   ` (3 more replies)
  0 siblings, 4 replies; 10+ messages in thread
From: menglong8.dong @ 2021-05-28 14:37 UTC (permalink / raw)
  To: mhiramat, mcgrof, josh
  Cc: viro, keescook, samitolvanen, ojeda, johan, jeyu, masahiroy,
	dong.menglong, joe, axboe, jack, hare, tj, gregkh, song, neilb,
	akpm, f.fainelli, wangkefeng.wang, arnd, linux, brho, rostedt,
	vbabka, pmladek, glider, chris, jojing64, ebiederm, mingo,
	terrelln, geert, linux-fsdevel, linux-kernel, bhelgaas

From: Menglong Dong <dong.menglong@zte.com.cn>

As Luis Chamberlain suggested, I split the patch:
[init/initramfs.c: make initramfs support pivot_root]
(https://lore.kernel.org/linux-fsdevel/20210520154244.20209-1-dong.menglong@zte.com.cn/)
into three.

The goal of the series patches is to make pivot_root() support initramfs.

In the first patch, I introduce the function ramdisk_exec_exist(), which
is used to check the exist of 'ramdisk_execute_command' in LOOKUP_DOWN
lookup mode.

In the second patch, I create a second mount, which is called
'user root', and make it become the root. Therefore, the root has a
parent mount, and it can be umounted or pivot_root.

In the third patch, I fix rootfs_fs_type with ramfs, as it is not used
directly any more, and it make no sense to switch it between ramfs and
tmpfs, just fix it with ramfs to simplify the code.


Changes since V2:

In the first patch, I use vfs_path_lookup() in init_eaccess() to make the
path lookup follow the mount on '/'. After this, the problem reported by
Masami Hiramatsu is solved. Thanks for your report :/


Changes since V1:

In the first patch, I add the flag LOOKUP_DOWN to init_eaccess(), to make
it support the check of filesystem mounted on '/'.

In the second patch, I control 'user root' with kconfig option
'CONFIG_INITRAMFS_USER_ROOT', and add some comments, as Luis Chamberlain
suggested.

In the third patch, I make 'rootfs_fs_type' in control of
'CONFIG_INITRAMFS_USER_ROOT'.



Menglong Dong (3):
  init/main.c: introduce function ramdisk_exec_exist()
  init/do_cmounts.c: introduce 'user_root' for initramfs
  init/do_mounts.c: fix rootfs_fs_type with ramfs

 fs/init.c            |  11 ++++-
 include/linux/init.h |   5 ++
 init/do_mounts.c     | 109 +++++++++++++++++++++++++++++++++++++++++++
 init/do_mounts.h     |  18 ++++++-
 init/initramfs.c     |  10 ++++
 init/main.c          |   7 ++-
 usr/Kconfig          |  10 ++++
 7 files changed, 166 insertions(+), 4 deletions(-)

-- 
2.32.0.rc0


^ permalink raw reply	[flat|nested] 10+ messages in thread

* [PATCH v3 1/3] init/main.c: introduce function ramdisk_exec_exist()
  2021-05-28 14:37 [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root menglong8.dong
@ 2021-05-28 14:38 ` menglong8.dong
  2021-05-28 14:38 ` [PATCH v3 2/3] init/do_cmounts.c: introduce 'user_root' for initramfs menglong8.dong
                   ` (2 subsequent siblings)
  3 siblings, 0 replies; 10+ messages in thread
From: menglong8.dong @ 2021-05-28 14:38 UTC (permalink / raw)
  To: mhiramat, mcgrof, josh
  Cc: viro, keescook, samitolvanen, ojeda, johan, jeyu, masahiroy,
	dong.menglong, joe, axboe, jack, hare, tj, gregkh, song, neilb,
	akpm, f.fainelli, wangkefeng.wang, arnd, linux, brho, rostedt,
	vbabka, pmladek, glider, chris, jojing64, ebiederm, mingo,
	terrelln, geert, linux-fsdevel, linux-kernel, bhelgaas

From: Menglong Dong <dong.menglong@zte.com.cn>

Introduce the function ramdisk_exec_exist, which is used to check the
exist of 'ramdisk_execute_command'.

To make path lookup follow the mount on '/', use vfs_path_lookup() in
init_eaccess(), and make the filesystem that mounted on '/' as root
during path lookup.

Signed-off-by: Menglong Dong <dong.menglong@zte.com.cn>
---
 fs/init.c   | 11 +++++++++--
 init/main.c |  7 ++++++-
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/fs/init.c b/fs/init.c
index 5c36adaa9b44..166356a1f15f 100644
--- a/fs/init.c
+++ b/fs/init.c
@@ -112,14 +112,21 @@ int __init init_chmod(const char *filename, umode_t mode)
 
 int __init init_eaccess(const char *filename)
 {
-	struct path path;
+	struct path path, root;
 	int error;
 
-	error = kern_path(filename, LOOKUP_FOLLOW, &path);
+	error = kern_path("/", LOOKUP_DOWN, &root);
 	if (error)
 		return error;
+	error = vfs_path_lookup(root.dentry, root.mnt, filename,
+				LOOKUP_FOLLOW, &path);
+	if (error)
+		goto on_err;
 	error = path_permission(&path, MAY_ACCESS);
+
 	path_put(&path);
+on_err:
+	path_put(&root);
 	return error;
 }
 
diff --git a/init/main.c b/init/main.c
index eb01e121d2f1..1153571ca977 100644
--- a/init/main.c
+++ b/init/main.c
@@ -1522,6 +1522,11 @@ void __init console_on_rootfs(void)
 	fput(file);
 }
 
+bool __init ramdisk_exec_exist(void)
+{
+	return init_eaccess(ramdisk_execute_command) == 0;
+}
+
 static noinline void __init kernel_init_freeable(void)
 {
 	/*
@@ -1568,7 +1573,7 @@ static noinline void __init kernel_init_freeable(void)
 	 * check if there is an early userspace init.  If yes, let it do all
 	 * the work
 	 */
-	if (init_eaccess(ramdisk_execute_command) != 0) {
+	if (!ramdisk_exec_exist()) {
 		ramdisk_execute_command = NULL;
 		prepare_namespace();
 	}
-- 
2.32.0.rc0


^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH v3 2/3] init/do_cmounts.c: introduce 'user_root' for initramfs
  2021-05-28 14:37 [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root menglong8.dong
  2021-05-28 14:38 ` [PATCH v3 1/3] init/main.c: introduce function ramdisk_exec_exist() menglong8.dong
@ 2021-05-28 14:38 ` menglong8.dong
  2021-06-01 14:39   ` Christian Brauner
  2021-05-28 14:38 ` [PATCH v3 3/3] init/do_mounts.c: fix rootfs_fs_type with ramfs menglong8.dong
  2021-05-29  2:26 ` [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root Masami Hiramatsu
  3 siblings, 1 reply; 10+ messages in thread
From: menglong8.dong @ 2021-05-28 14:38 UTC (permalink / raw)
  To: mhiramat, mcgrof, josh
  Cc: viro, keescook, samitolvanen, ojeda, johan, jeyu, masahiroy,
	dong.menglong, joe, axboe, jack, hare, tj, gregkh, song, neilb,
	akpm, f.fainelli, wangkefeng.wang, arnd, linux, brho, rostedt,
	vbabka, pmladek, glider, chris, jojing64, ebiederm, mingo,
	terrelln, geert, linux-fsdevel, linux-kernel, bhelgaas

From: Menglong Dong <dong.menglong@zte.com.cn>

If using container platforms such as Docker, upon initialization it
wants to use pivot_root() so that currently mounted devices do not
propagate to containers. An example of value in this is that
a USB device connected prior to the creation of a containers on the
host gets disconnected after a container is created; if the
USB device was mounted on containers, but already removed and
umounted on the host, the mount point will not go away until all
containers unmount the USB device.

Another reason for container platforms such as Docker to use pivot_root
is that upon initialization the net-namspace is mounted under
/var/run/docker/netns/ on the host by dockerd. Without pivot_root
Docker must either wait to create the network namespace prior to
the creation of containers or simply deal with leaking this to each
container.

pivot_root is supported if the rootfs is a initrd or block device, but
it's not supported if the rootfs uses an initramfs (tmpfs). This means
container platforms today must resort to using block devices if
they want to pivot_root from the rootfs. A workaround to use chroot()
is not a clean viable option given every container will have a
duplicate of every mount point on the host.

In order to support using container platforms such as Docker on
all the supported rootfs types we must extend Linux to support
pivot_root on initramfs as well. This patch does the work to do
just that.

pivot_root will unmount the mount of the rootfs from its parent mount
and mount the new root to it. However, when it comes to initramfs, it
donesn't work, because the root filesystem has not parent mount, which
makes initramfs not supported by pivot_root.

In order to support pivot_root on initramfs we introduce a second
"user_root" mount which is created before we do the cpio unpacking.
The filesystem of the "user_root" mount is the same the rootfs.

While mounting the 'user_root', 'rootflags' is passed to it, and it means
that we can set options for the mount of rootfs in boot cmd now.
For example, the size of tmpfs can be set with 'rootflags=size=1024M'.

Signed-off-by: Menglong Dong <dong.menglong@zte.com.cn>
---
 init/do_mounts.c | 101 +++++++++++++++++++++++++++++++++++++++++++++++
 init/do_mounts.h |  18 ++++++++-
 init/initramfs.c |  10 +++++
 usr/Kconfig      |  10 +++++
 4 files changed, 138 insertions(+), 1 deletion(-)

diff --git a/init/do_mounts.c b/init/do_mounts.c
index a78e44ee6adb..2fd168cca480 100644
--- a/init/do_mounts.c
+++ b/init/do_mounts.c
@@ -617,6 +617,107 @@ void __init prepare_namespace(void)
 	init_chroot(".");
 }
 
+#ifdef CONFIG_INITRAMFS_USER_ROOT
+#ifdef CONFIG_TMPFS
+static __init bool is_tmpfs_enabled(void)
+{
+	return (!root_fs_names || strstr(root_fs_names, "tmpfs")) &&
+	       !saved_root_name[0];
+}
+#endif
+
+static __init bool is_ramfs_enabled(void)
+{
+	return true;
+}
+
+struct fs_user_root {
+	bool (*enabled)(void);
+	char *dev_name;
+	char *fs_name;
+};
+
+static struct fs_user_root user_roots[] __initdata = {
+#ifdef CONFIG_TMPFS
+	{
+		.enabled  = is_tmpfs_enabled,
+		.dev_name = "tmpfs",
+		.fs_name  = "tmpfs",
+	},
+#endif
+	{
+		.enabled  = is_ramfs_enabled,
+		.dev_name = "ramfs",
+		.fs_name  = "ramfs"
+	}
+};
+static struct fs_user_root * __initdata user_root;
+
+/*
+ * The syscall 'pivot_root' is used to change root and it is able to
+ * clean the old mounts, which make it preferred by container platforms
+ * such as Docker. However, initramfs is not supported by pivot_root,
+ * and 'chroot()' has to be used, which is unable to clean the mounts
+ * that propagate from HOST. These useless mounts make the release of
+ * removable device or network namespace a big problem.
+ *
+ * To make initramfs supported by pivot_root, the mount of the root
+ * filesystem should have a parent, which will make it unmountable. In
+ * this function, the second mount, which is called 'user root', is
+ * created and mounted on '/root', and it will be made the root filesystem
+ * in end_mount_user_root() by init_chroot().
+ *
+ * The 'user root' has a parent mount, which makes it unmountable and
+ * pivot_root work.
+ *
+ * What's more, root_mountflags and root_mount_data are used here, which
+ * makes the 'rootflags' in boot cmd work for 'user root'.
+ */
+int __init mount_user_root(void)
+{
+	return do_mount_root(user_root->dev_name,
+			     user_root->fs_name,
+			     root_mountflags & ~MS_RDONLY,
+			     root_mount_data);
+}
+
+/*
+ * This function is used to chroot to new initramfs root that
+ * we unpacked on success. It will chdir to '/' and umount
+ * the secound mount on failure.
+ */
+void __init end_mount_user_root(bool succeed)
+{
+	init_chdir("/");
+	if (!succeed) {
+		init_umount("/root", 0);
+		return;
+	}
+
+	init_mount("/root", "/", NULL, MS_MOVE, NULL);
+	if (!ramdisk_exec_exist()) {
+		init_umount("/..", 0);
+		return;
+	}
+
+	init_chroot("/..");
+}
+
+void __init init_user_rootfs(void)
+{
+	struct fs_user_root *root;
+	int i;
+
+	for (i = 0; i < ARRAY_SIZE(user_roots); i++) {
+		root = &user_roots[i];
+		if (root->enabled()) {
+			user_root = root;
+			break;
+		}
+	}
+}
+#endif
+
 static bool is_tmpfs;
 static int rootfs_init_fs_context(struct fs_context *fc)
 {
diff --git a/init/do_mounts.h b/init/do_mounts.h
index 7a29ac3e427b..3802c7a3ba91 100644
--- a/init/do_mounts.h
+++ b/init/do_mounts.h
@@ -10,9 +10,25 @@
 #include <linux/root_dev.h>
 #include <linux/init_syscalls.h>
 
+extern int root_mountflags;
+
 void  mount_block_root(char *name, int flags);
 void  mount_root(void);
-extern int root_mountflags;
+bool  ramdisk_exec_exist(void);
+
+#ifdef CONFIG_INITRAMFS_USER_ROOT
+
+int   mount_user_root(void);
+void  end_mount_user_root(bool succeed);
+void  init_user_rootfs(void);
+
+#else
+
+static inline int   mount_user_root(void) { return 0; }
+static inline void  end_mount_user_root(bool succeed) { }
+static inline void  init_user_rootfs(void) { }
+
+#endif
 
 static inline __init int create_dev(char *name, dev_t dev)
 {
diff --git a/init/initramfs.c b/init/initramfs.c
index af27abc59643..ffa78932ae65 100644
--- a/init/initramfs.c
+++ b/init/initramfs.c
@@ -16,6 +16,8 @@
 #include <linux/namei.h>
 #include <linux/init_syscalls.h>
 
+#include "do_mounts.h"
+
 static ssize_t __init xwrite(struct file *file, const char *p, size_t count,
 		loff_t *pos)
 {
@@ -682,15 +684,23 @@ static void __init do_populate_rootfs(void *unused, async_cookie_t cookie)
 	else
 		printk(KERN_INFO "Unpacking initramfs...\n");
 
+	init_user_rootfs();
+
+	if (mount_user_root())
+		panic("Failed to create user root");
+
 	err = unpack_to_rootfs((char *)initrd_start, initrd_end - initrd_start);
 	if (err) {
+		end_mount_user_root(false);
 #ifdef CONFIG_BLK_DEV_RAM
 		populate_initrd_image(err);
 #else
 		printk(KERN_EMERG "Initramfs unpacking failed: %s\n", err);
 #endif
+		goto done;
 	}
 
+	end_mount_user_root(true);
 done:
 	/*
 	 * If the initrd region is overlapped with crashkernel reserved region,
diff --git a/usr/Kconfig b/usr/Kconfig
index 8bbcf699fe3b..f9c96de539c3 100644
--- a/usr/Kconfig
+++ b/usr/Kconfig
@@ -52,6 +52,16 @@ config INITRAMFS_ROOT_GID
 
 	  If you are not sure, leave it set to "0".
 
+config INITRAMFS_USER_ROOT
+	bool "Create 'user root' to make pivot_root supported"
+	default y
+	help
+	  Before unpacking cpio, create a second mount and make it become
+	  the root filesystem. Therefore, initramfs will be supported by
+	  pivot_root().
+
+	  If container platforms is used with initramfs, say Y.
+
 config RD_GZIP
 	bool "Support initial ramdisk/ramfs compressed using gzip"
 	default y
-- 
2.32.0.rc0



^ permalink raw reply related	[flat|nested] 10+ messages in thread

* [PATCH v3 3/3] init/do_mounts.c: fix rootfs_fs_type with ramfs
  2021-05-28 14:37 [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root menglong8.dong
  2021-05-28 14:38 ` [PATCH v3 1/3] init/main.c: introduce function ramdisk_exec_exist() menglong8.dong
  2021-05-28 14:38 ` [PATCH v3 2/3] init/do_cmounts.c: introduce 'user_root' for initramfs menglong8.dong
@ 2021-05-28 14:38 ` menglong8.dong
  2021-05-29  2:26 ` [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root Masami Hiramatsu
  3 siblings, 0 replies; 10+ messages in thread
From: menglong8.dong @ 2021-05-28 14:38 UTC (permalink / raw)
  To: mhiramat, mcgrof, josh
  Cc: viro, keescook, samitolvanen, ojeda, johan, jeyu, masahiroy,
	dong.menglong, joe, axboe, jack, hare, tj, gregkh, song, neilb,
	akpm, f.fainelli, wangkefeng.wang, arnd, linux, brho, rostedt,
	vbabka, pmladek, glider, chris, jojing64, ebiederm, mingo,
	terrelln, geert, linux-fsdevel, linux-kernel, bhelgaas

From: Menglong Dong <dong.menglong@zte.com.cn>

As for the existence of 'user root' which is introduced in previous
patch, 'rootfs_fs_type', which is used as the root of mount tree,
is not used directly any more. So it make no sense to make it tmpfs
while 'INITRAMFS_USER_ROOT' is enabled.

Make 'rootfs_fs_type' ramfs when 'INITRAMFS_USER_ROOT' enabled.

Signed-off-by: Menglong Dong <dong.menglong@zte.com.cn>
---
 include/linux/init.h |  5 +++++
 init/do_mounts.c     | 10 +++++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/include/linux/init.h b/include/linux/init.h
index 045ad1650ed1..d65b12fe438c 100644
--- a/include/linux/init.h
+++ b/include/linux/init.h
@@ -148,7 +148,12 @@ extern unsigned int reset_devices;
 /* used by init/main.c */
 void setup_arch(char **);
 void prepare_namespace(void);
+#ifndef CONFIG_INITRAMFS_USER_ROOT
 void __init init_rootfs(void);
+#else
+static inline void __init init_rootfs(void) { }
+#endif
+
 extern struct file_system_type rootfs_fs_type;
 
 #if defined(CONFIG_STRICT_KERNEL_RWX) || defined(CONFIG_STRICT_MODULE_RWX)
diff --git a/init/do_mounts.c b/init/do_mounts.c
index 2fd168cca480..74f5b0fc8bdf 100644
--- a/init/do_mounts.c
+++ b/init/do_mounts.c
@@ -716,7 +716,14 @@ void __init init_user_rootfs(void)
 		}
 	}
 }
-#endif
+
+struct file_system_type rootfs_fs_type = {
+	.name		= "rootfs",
+	.init_fs_context = ramfs_init_fs_context,
+	.kill_sb	= kill_litter_super,
+};
+
+#else
 
 static bool is_tmpfs;
 static int rootfs_init_fs_context(struct fs_context *fc)
@@ -739,3 +746,4 @@ void __init init_rootfs(void)
 		(!root_fs_names || strstr(root_fs_names, "tmpfs")))
 		is_tmpfs = true;
 }
+#endif
-- 
2.32.0.rc0



^ permalink raw reply related	[flat|nested] 10+ messages in thread

* Re: [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root
  2021-05-28 14:37 [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root menglong8.dong
                   ` (2 preceding siblings ...)
  2021-05-28 14:38 ` [PATCH v3 3/3] init/do_mounts.c: fix rootfs_fs_type with ramfs menglong8.dong
@ 2021-05-29  2:26 ` Masami Hiramatsu
  2021-06-01 13:55   ` Menglong Dong
  3 siblings, 1 reply; 10+ messages in thread
From: Masami Hiramatsu @ 2021-05-29  2:26 UTC (permalink / raw)
  To: menglong8.dong
  Cc: mcgrof, josh, viro, keescook, samitolvanen, ojeda, johan, jeyu,
	masahiroy, dong.menglong, joe, axboe, jack, hare, tj, gregkh,
	song, neilb, akpm, f.fainelli, wangkefeng.wang, arnd, linux,
	brho, rostedt, vbabka, pmladek, glider, chris, jojing64,
	ebiederm, mingo, terrelln, geert, linux-fsdevel, linux-kernel,
	bhelgaas

Hi Menglong,

On Fri, 28 May 2021 22:37:59 +0800
menglong8.dong@gmail.com wrote:

> From: Menglong Dong <dong.menglong@zte.com.cn>
> 
> As Luis Chamberlain suggested, I split the patch:
> [init/initramfs.c: make initramfs support pivot_root]
> (https://lore.kernel.org/linux-fsdevel/20210520154244.20209-1-dong.menglong@zte.com.cn/)
> into three.
> 
> The goal of the series patches is to make pivot_root() support initramfs.
> 
> In the first patch, I introduce the function ramdisk_exec_exist(), which
> is used to check the exist of 'ramdisk_execute_command' in LOOKUP_DOWN
> lookup mode.
> 
> In the second patch, I create a second mount, which is called
> 'user root', and make it become the root. Therefore, the root has a
> parent mount, and it can be umounted or pivot_root.
> 
> In the third patch, I fix rootfs_fs_type with ramfs, as it is not used
> directly any more, and it make no sense to switch it between ramfs and
> tmpfs, just fix it with ramfs to simplify the code.
> 
> 
> Changes since V2:
> 
> In the first patch, I use vfs_path_lookup() in init_eaccess() to make the
> path lookup follow the mount on '/'. After this, the problem reported by
> Masami Hiramatsu is solved. Thanks for your report :/

Thank you for the fix, I confirmed that the issue has been solved with this.

Tested-by: Masami Hiramatsu <mhiramat@kernel.org>

for this series.

Regards,


> 
> 
> Changes since V1:
> 
> In the first patch, I add the flag LOOKUP_DOWN to init_eaccess(), to make
> it support the check of filesystem mounted on '/'.
> 
> In the second patch, I control 'user root' with kconfig option
> 'CONFIG_INITRAMFS_USER_ROOT', and add some comments, as Luis Chamberlain
> suggested.
> 
> In the third patch, I make 'rootfs_fs_type' in control of
> 'CONFIG_INITRAMFS_USER_ROOT'.
> 
> 
> 
> Menglong Dong (3):
>   init/main.c: introduce function ramdisk_exec_exist()
>   init/do_cmounts.c: introduce 'user_root' for initramfs
>   init/do_mounts.c: fix rootfs_fs_type with ramfs
> 
>  fs/init.c            |  11 ++++-
>  include/linux/init.h |   5 ++
>  init/do_mounts.c     | 109 +++++++++++++++++++++++++++++++++++++++++++
>  init/do_mounts.h     |  18 ++++++-
>  init/initramfs.c     |  10 ++++
>  init/main.c          |   7 ++-
>  usr/Kconfig          |  10 ++++
>  7 files changed, 166 insertions(+), 4 deletions(-)
> 
> -- 
> 2.32.0.rc0
> 


-- 
Masami Hiramatsu <mhiramat@kernel.org>

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root
  2021-05-29  2:26 ` [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root Masami Hiramatsu
@ 2021-06-01 13:55   ` Menglong Dong
  2021-06-01 14:03     ` Matthew Wilcox
  0 siblings, 1 reply; 10+ messages in thread
From: Menglong Dong @ 2021-06-01 13:55 UTC (permalink / raw)
  To: Luis Chamberlain, Josh Triplett
  Cc: Alexander Viro, Masami Hiramatsu, Kees Cook, Sami Tolvanen,
	ojeda, johan, jeyu, masahiroy, Menglong Dong, joe, Jens Axboe,
	Jan Kara, hare, tj, gregkh, song, NeilBrown, Andrew Morton,
	f.fainelli, wangkefeng.wang, arnd, Rasmus Villemoes,
	Barret Rhoden, Steven Rostedt, vbabka, pmladek,
	Alexander Potapenko, Chris Down, jojing64, Eric W. Biederman,
	mingo, terrelln, geert, linux-fsdevel, LKML, Bjorn Helgaas

Hello!

What's the status or fate of this patch? Does anyone do an in-depth
study of this field? Knock-knock~

On Sat, May 29, 2021 at 10:26 AM Masami Hiramatsu <mhiramat@kernel.org> wrote:
>
> Hi Menglong,
>
> On Fri, 28 May 2021 22:37:59 +0800
> menglong8.dong@gmail.com wrote:
>
> > From: Menglong Dong <dong.menglong@zte.com.cn>
> >
> > As Luis Chamberlain suggested, I split the patch:
> > [init/initramfs.c: make initramfs support pivot_root]
> > (https://lore.kernel.org/linux-fsdevel/20210520154244.20209-1-dong.menglong@zte.com.cn/)
> > into three.
> >
> > The goal of the series patches is to make pivot_root() support initramfs.
> >
> > In the first patch, I introduce the function ramdisk_exec_exist(), which
> > is used to check the exist of 'ramdisk_execute_command' in LOOKUP_DOWN
> > lookup mode.
> >
> > In the second patch, I create a second mount, which is called
> > 'user root', and make it become the root. Therefore, the root has a
> > parent mount, and it can be umounted or pivot_root.
> >
> > In the third patch, I fix rootfs_fs_type with ramfs, as it is not used
> > directly any more, and it make no sense to switch it between ramfs and
> > tmpfs, just fix it with ramfs to simplify the code.
> >
> >
> > Changes since V2:
> >
> > In the first patch, I use vfs_path_lookup() in init_eaccess() to make the
> > path lookup follow the mount on '/'. After this, the problem reported by
> > Masami Hiramatsu is solved. Thanks for your report :/
>
> Thank you for the fix, I confirmed that the issue has been solved with this.
>
> Tested-by: Masami Hiramatsu <mhiramat@kernel.org>
>
> for this series.
>
> Regards,
>
>
> >
> >
> > Changes since V1:
> >
> > In the first patch, I add the flag LOOKUP_DOWN to init_eaccess(), to make
> > it support the check of filesystem mounted on '/'.
> >
> > In the second patch, I control 'user root' with kconfig option
> > 'CONFIG_INITRAMFS_USER_ROOT', and add some comments, as Luis Chamberlain
> > suggested.
> >
> > In the third patch, I make 'rootfs_fs_type' in control of
> > 'CONFIG_INITRAMFS_USER_ROOT'.
> >
> >
> >
> > Menglong Dong (3):
> >   init/main.c: introduce function ramdisk_exec_exist()
> >   init/do_cmounts.c: introduce 'user_root' for initramfs
> >   init/do_mounts.c: fix rootfs_fs_type with ramfs
> >
> >  fs/init.c            |  11 ++++-
> >  include/linux/init.h |   5 ++
> >  init/do_mounts.c     | 109 +++++++++++++++++++++++++++++++++++++++++++
> >  init/do_mounts.h     |  18 ++++++-
> >  init/initramfs.c     |  10 ++++
> >  init/main.c          |   7 ++-
> >  usr/Kconfig          |  10 ++++
> >  7 files changed, 166 insertions(+), 4 deletions(-)
> >
> > --
> > 2.32.0.rc0
> >
>
>
> --
> Masami Hiramatsu <mhiramat@kernel.org>

Thanks!
Menglong Dong

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root
  2021-06-01 13:55   ` Menglong Dong
@ 2021-06-01 14:03     ` Matthew Wilcox
  2021-06-01 14:25       ` Menglong Dong
  0 siblings, 1 reply; 10+ messages in thread
From: Matthew Wilcox @ 2021-06-01 14:03 UTC (permalink / raw)
  To: Menglong Dong
  Cc: Luis Chamberlain, Josh Triplett, Alexander Viro,
	Masami Hiramatsu, Kees Cook, Sami Tolvanen, ojeda, johan, jeyu,
	masahiroy, Menglong Dong, joe, Jens Axboe, Jan Kara, hare, tj,
	gregkh, song, NeilBrown, Andrew Morton, f.fainelli,
	wangkefeng.wang, arnd, Rasmus Villemoes, Barret Rhoden,
	Steven Rostedt, vbabka, pmladek, Alexander Potapenko, Chris Down,
	jojing64, Eric W. Biederman, mingo, terrelln, geert,
	linux-fsdevel, LKML, Bjorn Helgaas

On Tue, Jun 01, 2021 at 09:55:33PM +0800, Menglong Dong wrote:
> Hello!
> 
> What's the status or fate of this patch? Does anyone do an in-depth
> study of this field? Knock-knock~

You sent this on Friday.  Monday was a holiday in the USA.  Generally
you should wait a week before pinging a patch.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root
  2021-06-01 14:03     ` Matthew Wilcox
@ 2021-06-01 14:25       ` Menglong Dong
  0 siblings, 0 replies; 10+ messages in thread
From: Menglong Dong @ 2021-06-01 14:25 UTC (permalink / raw)
  To: Matthew Wilcox
  Cc: Luis Chamberlain, Josh Triplett, Alexander Viro,
	Masami Hiramatsu, Kees Cook, Sami Tolvanen, ojeda, johan, jeyu,
	masahiroy, Menglong Dong, joe, Jens Axboe, Jan Kara, hare, tj,
	gregkh, song, NeilBrown, Andrew Morton, f.fainelli,
	wangkefeng.wang, arnd, Rasmus Villemoes, Barret Rhoden,
	Steven Rostedt, vbabka, pmladek, Alexander Potapenko, Chris Down,
	jojing64, Eric W. Biederman, mingo, terrelln, geert,
	linux-fsdevel, LKML, Bjorn Helgaas

On Tue, Jun 1, 2021 at 10:03 PM Matthew Wilcox <willy@infradead.org> wrote:
[...]

>
> You sent this on Friday.  Monday was a holiday in the USA.  Generally
> you should wait a week before pinging a patch.

Ok, get it! I'll keep it in mind this time :/

Thanks!
Menglong Dong

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH v3 2/3] init/do_cmounts.c: introduce 'user_root' for initramfs
  2021-05-28 14:38 ` [PATCH v3 2/3] init/do_cmounts.c: introduce 'user_root' for initramfs menglong8.dong
@ 2021-06-01 14:39   ` Christian Brauner
  2021-06-02  2:56     ` Menglong Dong
  0 siblings, 1 reply; 10+ messages in thread
From: Christian Brauner @ 2021-06-01 14:39 UTC (permalink / raw)
  To: menglong8.dong
  Cc: mhiramat, mcgrof, josh, viro, keescook, samitolvanen, ojeda,
	johan, jeyu, masahiroy, dong.menglong, joe, axboe, jack, hare,
	tj, gregkh, song, neilb, akpm, f.fainelli, wangkefeng.wang, arnd,
	linux, brho, rostedt, vbabka, pmladek, glider, chris, jojing64,
	ebiederm, mingo, terrelln, geert, linux-fsdevel, linux-kernel,
	bhelgaas

On Fri, May 28, 2021 at 10:38:01PM +0800, menglong8.dong@gmail.com wrote:
> From: Menglong Dong <dong.menglong@zte.com.cn>
> 
> If using container platforms such as Docker, upon initialization it
> wants to use pivot_root() so that currently mounted devices do not
> propagate to containers. An example of value in this is that
> a USB device connected prior to the creation of a containers on the
> host gets disconnected after a container is created; if the
> USB device was mounted on containers, but already removed and
> umounted on the host, the mount point will not go away until all
> containers unmount the USB device.
> 
> Another reason for container platforms such as Docker to use pivot_root
> is that upon initialization the net-namspace is mounted under
> /var/run/docker/netns/ on the host by dockerd. Without pivot_root
> Docker must either wait to create the network namespace prior to
> the creation of containers or simply deal with leaking this to each
> container.
> 
> pivot_root is supported if the rootfs is a initrd or block device, but
> it's not supported if the rootfs uses an initramfs (tmpfs). This means
> container platforms today must resort to using block devices if
> they want to pivot_root from the rootfs. A workaround to use chroot()
> is not a clean viable option given every container will have a
> duplicate of every mount point on the host.
> 
> In order to support using container platforms such as Docker on
> all the supported rootfs types we must extend Linux to support
> pivot_root on initramfs as well. This patch does the work to do
> just that.
> 
> pivot_root will unmount the mount of the rootfs from its parent mount
> and mount the new root to it. However, when it comes to initramfs, it
> donesn't work, because the root filesystem has not parent mount, which
> makes initramfs not supported by pivot_root.
> 
> In order to support pivot_root on initramfs we introduce a second
> "user_root" mount which is created before we do the cpio unpacking.
> The filesystem of the "user_root" mount is the same the rootfs.
> 
> While mounting the 'user_root', 'rootflags' is passed to it, and it means
> that we can set options for the mount of rootfs in boot cmd now.
> For example, the size of tmpfs can be set with 'rootflags=size=1024M'.
> 
> Signed-off-by: Menglong Dong <dong.menglong@zte.com.cn>
> ---
>  init/do_mounts.c | 101 +++++++++++++++++++++++++++++++++++++++++++++++
>  init/do_mounts.h |  18 ++++++++-
>  init/initramfs.c |  10 +++++
>  usr/Kconfig      |  10 +++++
>  4 files changed, 138 insertions(+), 1 deletion(-)
> 
> diff --git a/init/do_mounts.c b/init/do_mounts.c
> index a78e44ee6adb..2fd168cca480 100644
> --- a/init/do_mounts.c
> +++ b/init/do_mounts.c
> @@ -617,6 +617,107 @@ void __init prepare_namespace(void)
>  	init_chroot(".");
>  }
>  
> +#ifdef CONFIG_INITRAMFS_USER_ROOT
> +#ifdef CONFIG_TMPFS
> +static __init bool is_tmpfs_enabled(void)
> +{
> +	return (!root_fs_names || strstr(root_fs_names, "tmpfs")) &&
> +	       !saved_root_name[0];
> +}
> +#endif

This code is duplicated below in this file

void __init init_rootfs(void)
{
	if (IS_ENABLED(CONFIG_TMPFS) && !saved_root_name[0] &&
		(!root_fs_names || strstr(root_fs_names, "tmpfs")))
		is_tmpfs = true;
}
                                        
so you should add a tiny inline helper that can be called in both
places. Will also allow you to get rid of one ifdef and makes the patch
smaller.

> +
> +static __init bool is_ramfs_enabled(void)
> +{
> +	return true;
> +}
> +
> +struct fs_user_root {
> +	bool (*enabled)(void);
> +	char *dev_name;
> +	char *fs_name;
> +};
> +
> +static struct fs_user_root user_roots[] __initdata = {
> +#ifdef CONFIG_TMPFS
> +	{
> +		.enabled  = is_tmpfs_enabled,
> +		.dev_name = "tmpfs",
> +		.fs_name  = "tmpfs",
> +	},
> +#endif
> +	{
> +		.enabled  = is_ramfs_enabled,
> +		.dev_name = "ramfs",
> +		.fs_name  = "ramfs"
> +	}
> +};
> +static struct fs_user_root * __initdata user_root;
> +
> +/*
> + * The syscall 'pivot_root' is used to change root and it is able to
> + * clean the old mounts, which make it preferred by container platforms
> + * such as Docker. However, initramfs is not supported by pivot_root,
> + * and 'chroot()' has to be used, which is unable to clean the mounts
> + * that propagate from HOST. These useless mounts make the release of
> + * removable device or network namespace a big problem.
> + *
> + * To make initramfs supported by pivot_root, the mount of the root
> + * filesystem should have a parent, which will make it unmountable. In
> + * this function, the second mount, which is called 'user root', is
> + * created and mounted on '/root', and it will be made the root filesystem
> + * in end_mount_user_root() by init_chroot().
> + *
> + * The 'user root' has a parent mount, which makes it unmountable and
> + * pivot_root work.
> + *
> + * What's more, root_mountflags and root_mount_data are used here, which
> + * makes the 'rootflags' in boot cmd work for 'user root'.

I appreciate the detail but most of that should go in the commit
message it also repeats some info a couple of times. :) Here sm like the
following should suffice, I think:

/*
 * Give systems running from the initramfs and making use of pivot_root a
 * proper mount so it can be umounted during pivot_root.
 */

> + */
> +int __init mount_user_root(void)
> +{
> +	return do_mount_root(user_root->dev_name,
> +			     user_root->fs_name,
> +			     root_mountflags & ~MS_RDONLY,
> +			     root_mount_data);
> +}
> +
> +/*
> + * This function is used to chroot to new initramfs root that
> + * we unpacked on success. It will chdir to '/' and umount
> + * the secound mount on failure.
> + */
> +void __init end_mount_user_root(bool succeed)
> +{
> +	init_chdir("/");
> +	if (!succeed) {
> +		init_umount("/root", 0);
> +		return;
> +	}
> +
> +	init_mount("/root", "/", NULL, MS_MOVE, NULL);
> +	if (!ramdisk_exec_exist()) {
> +		init_umount("/..", 0);
> +		return;
> +	}
> +
> +	init_chroot("/..");
> +}
> +
> +void __init init_user_rootfs(void)
> +{
> +	struct fs_user_root *root;
> +	int i;
> +
> +	for (i = 0; i < ARRAY_SIZE(user_roots); i++) {
> +		root = &user_roots[i];
> +		if (root->enabled()) {
> +			user_root = root;
> +			break;
> +		}
> +	}
> +}
> +#endif
> +
>  static bool is_tmpfs;
>  static int rootfs_init_fs_context(struct fs_context *fc)
>  {
> diff --git a/init/do_mounts.h b/init/do_mounts.h
> index 7a29ac3e427b..3802c7a3ba91 100644
> --- a/init/do_mounts.h
> +++ b/init/do_mounts.h
> @@ -10,9 +10,25 @@
>  #include <linux/root_dev.h>
>  #include <linux/init_syscalls.h>
>  
> +extern int root_mountflags;
> +
>  void  mount_block_root(char *name, int flags);
>  void  mount_root(void);
> -extern int root_mountflags;
> +bool  ramdisk_exec_exist(void);
> +
> +#ifdef CONFIG_INITRAMFS_USER_ROOT
> +
> +int   mount_user_root(void);
> +void  end_mount_user_root(bool succeed);
> +void  init_user_rootfs(void);
> +
> +#else
> +
> +static inline int   mount_user_root(void) { return 0; }
> +static inline void  end_mount_user_root(bool succeed) { }
> +static inline void  init_user_rootfs(void) { }
> +
> +#endif
>  
>  static inline __init int create_dev(char *name, dev_t dev)
>  {
> diff --git a/init/initramfs.c b/init/initramfs.c
> index af27abc59643..ffa78932ae65 100644
> --- a/init/initramfs.c
> +++ b/init/initramfs.c
> @@ -16,6 +16,8 @@
>  #include <linux/namei.h>
>  #include <linux/init_syscalls.h>
>  
> +#include "do_mounts.h"
> +
>  static ssize_t __init xwrite(struct file *file, const char *p, size_t count,
>  		loff_t *pos)
>  {
> @@ -682,15 +684,23 @@ static void __init do_populate_rootfs(void *unused, async_cookie_t cookie)
>  	else
>  		printk(KERN_INFO "Unpacking initramfs...\n");
>  
> +	init_user_rootfs();
> +
> +	if (mount_user_root())

I would call this sm like

prepare_mount_rootfs()
finish_mount_rootfs()

> +		panic("Failed to create user root");

I don't think you need to call init_user_rootfs() separately? You could
just move it into the prepare_mount_rootfs()/mount_user_root() call.

> +
>  	err = unpack_to_rootfs((char *)initrd_start, initrd_end - initrd_start);
>  	if (err) {
> +		end_mount_user_root(false);

This boolean argument to end_mount_user_root() is a bit strange. Just
call init_umount() directly here?

>  #ifdef CONFIG_BLK_DEV_RAM
>  		populate_initrd_image(err);
>  #else
>  		printk(KERN_EMERG "Initramfs unpacking failed: %s\n", err);
>  #endif
> +		goto done;
>  	}
>  
> +	end_mount_user_root(true);
>  done:
>  	/*
>  	 * If the initrd region is overlapped with crashkernel reserved region,
> diff --git a/usr/Kconfig b/usr/Kconfig
> index 8bbcf699fe3b..f9c96de539c3 100644
> --- a/usr/Kconfig
> +++ b/usr/Kconfig
> @@ -52,6 +52,16 @@ config INITRAMFS_ROOT_GID
>  
>  	  If you are not sure, leave it set to "0".
>  
> +config INITRAMFS_USER_ROOT

I think the naming isn't great. Just call it INITRAMFS_MOUNT. The "user"
part in all the function and variabe names seems confusing to me at
least it doesn't convey a lot of useful info. So I'd just drop it and
try to stick with plain rootfs/initramfs terminology.

> +	bool "Create 'user root' to make pivot_root supported"
> +	default y
> +	help
> +	  Before unpacking cpio, create a second mount and make it become
> +	  the root filesystem. Therefore, initramfs will be supported by
> +	  pivot_root().
> +
> +	  If container platforms is used with initramfs, say Y.
> +
>  config RD_GZIP
>  	bool "Support initial ramdisk/ramfs compressed using gzip"
>  	default y
> -- 
> 2.32.0.rc0
> 
> 

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH v3 2/3] init/do_cmounts.c: introduce 'user_root' for initramfs
  2021-06-01 14:39   ` Christian Brauner
@ 2021-06-02  2:56     ` Menglong Dong
  0 siblings, 0 replies; 10+ messages in thread
From: Menglong Dong @ 2021-06-02  2:56 UTC (permalink / raw)
  To: Christian Brauner
  Cc: Masami Hiramatsu, Luis Chamberlain, Josh Triplett,
	Alexander Viro, Kees Cook, Sami Tolvanen, ojeda, johan, jeyu,
	masahiroy, Menglong Dong, joe, Jens Axboe, Jan Kara, hare, tj,
	gregkh, song, NeilBrown, Andrew Morton, f.fainelli,
	wangkefeng.wang, arnd, Rasmus Villemoes, Barret Rhoden,
	Steven Rostedt, vbabka, pmladek, Alexander Potapenko, Chris Down,
	jojing64, Eric W. Biederman, mingo, terrelln, geert,
	linux-fsdevel, LKML, Bjorn Helgaas

On Tue, Jun 1, 2021 at 10:39 PM Christian Brauner
<christian.brauner@ubuntu.com> wrote:
>
[...]
>
> This code is duplicated below in this file
>
> void __init init_rootfs(void)
> {
>         if (IS_ENABLED(CONFIG_TMPFS) && !saved_root_name[0] &&
>                 (!root_fs_names || strstr(root_fs_names, "tmpfs")))
>                 is_tmpfs = true;
> }
>
> so you should add a tiny inline helper that can be called in both
> places. Will also allow you to get rid of one ifdef and makes the patch
> smaller.

Seems the code here is indeed duplicated, I'll replace it with an inline
function.

[...]
> > +
> > +/*
> > + * The syscall 'pivot_root' is used to change root and it is able to
> > + * clean the old mounts, which make it preferred by container platforms
> > + * such as Docker. However, initramfs is not supported by pivot_root,
> > + * and 'chroot()' has to be used, which is unable to clean the mounts
> > + * that propagate from HOST. These useless mounts make the release of
> > + * removable device or network namespace a big problem.
> > + *
> > + * To make initramfs supported by pivot_root, the mount of the root
> > + * filesystem should have a parent, which will make it unmountable. In
> > + * this function, the second mount, which is called 'user root', is
> > + * created and mounted on '/root', and it will be made the root filesystem
> > + * in end_mount_user_root() by init_chroot().
> > + *
> > + * The 'user root' has a parent mount, which makes it unmountable and
> > + * pivot_root work.
> > + *
> > + * What's more, root_mountflags and root_mount_data are used here, which
> > + * makes the 'rootflags' in boot cmd work for 'user root'.
>
> I appreciate the detail but most of that should go in the commit
> message it also repeats some info a couple of times. :) Here sm like the
> following should suffice, I think:
>
> /*
>  * Give systems running from the initramfs and making use of pivot_root a
>  * proper mount so it can be umounted during pivot_root.
>  */

I added the comments here to make the folks understand what these changes
are for, as LuisChamberlain suggested. Do you think that it is
unnecessary and the commit message is enough for users to understand this
function?

[...]
> > +
> >  static ssize_t __init xwrite(struct file *file, const char *p, size_t count,
> >               loff_t *pos)
> >  {
> > @@ -682,15 +684,23 @@ static void __init do_populate_rootfs(void *unused, async_cookie_t cookie)
> >       else
> >               printk(KERN_INFO "Unpacking initramfs...\n");
> >
> > +     init_user_rootfs();
> > +
> > +     if (mount_user_root())
>
> I would call this sm like
>
> prepare_mount_rootfs()
> finish_mount_rootfs()

Yeah, this name seems better! I'll change it.

>
> > +             panic("Failed to create user root");
>
> I don't think you need to call init_user_rootfs() separately? You could
> just move it into the prepare_mount_rootfs()/mount_user_root() call.

After rename 'mount_user_root()' to 'prepare_mount_rootfs()', it seems
reasonable to call 'init_user_rootfs()' in 'prepare_mount_rootfs()'.

>
> > +
> >       err = unpack_to_rootfs((char *)initrd_start, initrd_end - initrd_start);
> >       if (err) {
> > +             end_mount_user_root(false);
>
> This boolean argument to end_mount_user_root() is a bit strange. Just
> call init_umount() directly here?

I don't think it is suitable to call init_umount() directly here. Before
umount, 'init_chdir("/")' should be called too, and it seems a little
weird to do these stuff in do_populate_rootfs().

According to the result, finish_mount_rootfs() will change root to the new
mount or fall back and do the clean work, it seems fine.

>
> >  #ifdef CONFIG_BLK_DEV_RAM
> >               populate_initrd_image(err);
> >  #else
> >               printk(KERN_EMERG "Initramfs unpacking failed: %s\n", err);
> >  #endif
> > +             goto done;
> >       }
> >
> > +     end_mount_user_root(true);
> >  done:
> >       /*
> >        * If the initrd region is overlapped with crashkernel reserved region,
> > diff --git a/usr/Kconfig b/usr/Kconfig
> > index 8bbcf699fe3b..f9c96de539c3 100644
> > --- a/usr/Kconfig
> > +++ b/usr/Kconfig
> > @@ -52,6 +52,16 @@ config INITRAMFS_ROOT_GID
> >
> >         If you are not sure, leave it set to "0".
> >
> > +config INITRAMFS_USER_ROOT
>
> I think the naming isn't great. Just call it INITRAMFS_MOUNT. The "user"
> part in all the function and variabe names seems confusing to me at
> least it doesn't convey a lot of useful info. So I'd just drop it and
> try to stick with plain rootfs/initramfs terminology.

Yeah, it now appears that 'user' seems indeed weird here. I thought that
this mount is created for user space, seems kernel is using it too. I'll
clean these 'user'.

I appreciate your detail comments, thank you!



Thanks!
Menglong Dong

^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2021-06-02  2:57 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-05-28 14:37 [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root menglong8.dong
2021-05-28 14:38 ` [PATCH v3 1/3] init/main.c: introduce function ramdisk_exec_exist() menglong8.dong
2021-05-28 14:38 ` [PATCH v3 2/3] init/do_cmounts.c: introduce 'user_root' for initramfs menglong8.dong
2021-06-01 14:39   ` Christian Brauner
2021-06-02  2:56     ` Menglong Dong
2021-05-28 14:38 ` [PATCH v3 3/3] init/do_mounts.c: fix rootfs_fs_type with ramfs menglong8.dong
2021-05-29  2:26 ` [PATCH v3 0/3] init/initramfs.c: make initramfs support pivot_root Masami Hiramatsu
2021-06-01 13:55   ` Menglong Dong
2021-06-01 14:03     ` Matthew Wilcox
2021-06-01 14:25       ` Menglong Dong

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).