€•²d      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”ŒF/translations/zh_CN/driver-api/early-userspace/early_userspace_support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”ŒF/translations/zh_TW/driver-api/early-userspace/early_userspace_support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”ŒF/translations/it_IT/driver-api/early-userspace/early_userspace_support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”ŒF/translations/ja_JP/driver-api/early-userspace/early_userspace_support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”ŒF/translations/ko_KR/driver-api/early-userspace/early_userspace_support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”ŒF/translations/sp_SP/driver-api/early-userspace/early_userspace_support”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒEarly userspace support”h]”hŒEarly userspace support”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒ`/var/lib/git/docbuild/linux/Documentation/driver-api/early-userspace/early_userspace_support.rst”h KubhŒ	paragraph”“”)”}”(hŒLast update: 2004-12-20 tlh”h]”hŒLast update: 2004-12-20 tlh”…””}”(hh¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hŒæ"Early userspace" is a set of libraries and programs that provide
various pieces of functionality that are important enough to be
available while a Linux kernel is coming up, but that don't need to be
run inside the kernel itself.”h]”hŒìâ€œEarly userspaceâ€ is a set of libraries and programs that provide
various pieces of functionality that are important enough to be
available while a Linux kernel is coming up, but that donâ€™t need to be
run inside the kernel itself.”…””}”(hhÇhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hŒ7It consists of several major infrastructure components:”h]”hŒ7It consists of several major infrastructure components:”…””}”(hhÕhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒµgen_init_cpio, a program that builds a cpio-format archive
containing a root filesystem image.  This archive is compressed, and
the compressed image is linked into the kernel image.”h]”h¸)”}”(hŒµgen_init_cpio, a program that builds a cpio-format archive
containing a root filesystem image.  This archive is compressed, and
the compressed image is linked into the kernel image.”h]”hŒµgen_init_cpio, a program that builds a cpio-format archive
containing a root filesystem image.  This archive is compressed, and
the compressed image is linked into the kernel image.”…””}”(hhîhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khhêubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhhåhžhhŸh¶h Nubhé)”}”(hŒiinitramfs, a chunk of code that unpacks the compressed cpio image
midway through the kernel boot process.”h]”h¸)”}”(hŒiinitramfs, a chunk of code that unpacks the compressed cpio image
midway through the kernel boot process.”h]”hŒiinitramfs, a chunk of code that unpacks the compressed cpio image
midway through the kernel boot process.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhhåhžhhŸh¶h Nubhé)”}”(hŒoklibc, a userspace C library, currently packaged separately, that is
optimized for correctness and small size.
”h]”h¸)”}”(hŒnklibc, a userspace C library, currently packaged separately, that is
optimized for correctness and small size.”h]”hŒnklibc, a userspace C library, currently packaged separately, that is
optimized for correctness and small size.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhhåhžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1hãhŸh¶h Khh£hžhubh¸)”}”(hX8  The cpio file format used by initramfs is the "newc" (aka "cpio -H newc")
format, and is documented in the file "buffer-format.txt".  There are
two ways to add an early userspace image: specify an existing cpio
archive to be used as the image or have the kernel build process build
the image from specifications.”h]”hXD  The cpio file format used by initramfs is the â€œnewcâ€ (aka â€œcpio -H newcâ€)
format, and is documented in the file â€œbuffer-format.txtâ€.  There are
two ways to add an early userspace image: specify an existing cpio
archive to be used as the image or have the kernel build process build
the image from specifications.”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¢)”}”(hhh]”(h§)”}”(hŒCPIO ARCHIVE method”h]”hŒCPIO ARCHIVE method”…””}”(hjK  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjH  hžhhŸh¶h Kubh¸)”}”(hX;  You can create a cpio archive that contains the early userspace image.
Your cpio archive should be specified in CONFIG_INITRAMFS_SOURCE and it
will be used directly.  Only a single cpio file may be specified in
CONFIG_INITRAMFS_SOURCE and directory and file names are not allowed in
combination with a cpio archive.”h]”hX;  You can create a cpio archive that contains the early userspace image.
Your cpio archive should be specified in CONFIG_INITRAMFS_SOURCE and it
will be used directly.  Only a single cpio file may be specified in
CONFIG_INITRAMFS_SOURCE and directory and file names are not allowed in
combination with a cpio archive.”…””}”(hjY  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K hjH  hžhubeh}”(h]”Œcpio-archive-method”ah ]”h"]”Œcpio archive method”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒIMAGE BUILDING method”h]”hŒIMAGE BUILDING method”…””}”(hjr  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjo  hžhhŸh¶h K'ubh¸)”}”(hŒôThe kernel build process can also build an early userspace image from
source parts rather than supplying a cpio archive.  This method provides
a way to create images with root-owned files even though the image was
built by an unprivileged user.”h]”hŒôThe kernel build process can also build an early userspace image from
source parts rather than supplying a cpio archive.  This method provides
a way to create images with root-owned files even though the image was
built by an unprivileged user.”…””}”(hj€  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K)hjo  hžhubh¸)”}”(hŒ³The image is specified as one or more sources in
CONFIG_INITRAMFS_SOURCE.  Sources can be either directories or files -
cpio archives are *not* allowed when building from sources.”h]”(hŒŠThe image is specified as one or more sources in
CONFIG_INITRAMFS_SOURCE.  Sources can be either directories or files -
cpio archives are ”…””}”(hjŽ  hžhhŸNh NubhŒemphasis”“”)”}”(hŒ*not*”h]”hŒnot”…””}”(hj˜  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j–  hjŽ  ubhŒ$ allowed when building from sources.”…””}”(hjŽ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K.hjo  hžhubh¸)”}”(hXx  A source directory will have it and all of its contents packaged.  The
specified directory name will be mapped to '/'.  When packaging a
directory, limited user and group ID translation can be performed.
INITRAMFS_ROOT_UID can be set to a user ID that needs to be mapped to
user root (0).  INITRAMFS_ROOT_GID can be set to a group ID that needs
to be mapped to group root (0).”h]”hX|  A source directory will have it and all of its contents packaged.  The
specified directory name will be mapped to â€˜/â€™.  When packaging a
directory, limited user and group ID translation can be performed.
INITRAMFS_ROOT_UID can be set to a user ID that needs to be mapped to
user root (0).  INITRAMFS_ROOT_GID can be set to a group ID that needs
to be mapped to group root (0).”…””}”(hj°  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K2hjo  hžhubh¸)”}”(hŒ×A source file must be directives in the format required by the
usr/gen_init_cpio utility (run 'usr/gen_init_cpio -h' to get the
file format).  The directives in the file will be passed directly to
usr/gen_init_cpio.”h]”hŒÛA source file must be directives in the format required by the
usr/gen_init_cpio utility (run â€˜usr/gen_init_cpio -hâ€™ to get the
file format).  The directives in the file will be passed directly to
usr/gen_init_cpio.”…””}”(hj¾  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K9hjo  hžhubh¸)”}”(hXá  When a combination of directories and files are specified then the
initramfs image will be an aggregate of all of them.  In this way a user
can create a 'root-image' directory and install all files into it.
Because device-special files cannot be created by a unprivileged user,
special files can be listed in a 'root-files' file.  Both 'root-image'
and 'root-files' can be listed in CONFIG_INITRAMFS_SOURCE and a complete
early userspace image can be built by an unprivileged user.”h]”hXñ  When a combination of directories and files are specified then the
initramfs image will be an aggregate of all of them.  In this way a user
can create a â€˜root-imageâ€™ directory and install all files into it.
Because device-special files cannot be created by a unprivileged user,
special files can be listed in a â€˜root-filesâ€™ file.  Both â€˜root-imageâ€™
and â€˜root-filesâ€™ can be listed in CONFIG_INITRAMFS_SOURCE and a complete
early userspace image can be built by an unprivileged user.”…””}”(hjÌ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K>hjo  hžhubh¸)”}”(hXˆ  As a technical note, when directories and files are specified, the
entire CONFIG_INITRAMFS_SOURCE is passed to
usr/gen_initramfs.sh.  This means that CONFIG_INITRAMFS_SOURCE
can really be interpreted as any legal argument to
gen_initramfs.sh.  If a directory is specified as an argument then
the contents are scanned, uid/gid translation is performed, and
usr/gen_init_cpio file directives are output.  If a directory is
specified as an argument to usr/gen_initramfs.sh then the
contents of the file are simply copied to the output.  All of the output
directives from directory scanning and file contents copying are
processed by usr/gen_init_cpio.”h]”hXˆ  As a technical note, when directories and files are specified, the
entire CONFIG_INITRAMFS_SOURCE is passed to
usr/gen_initramfs.sh.  This means that CONFIG_INITRAMFS_SOURCE
can really be interpreted as any legal argument to
gen_initramfs.sh.  If a directory is specified as an argument then
the contents are scanned, uid/gid translation is performed, and
usr/gen_init_cpio file directives are output.  If a directory is
specified as an argument to usr/gen_initramfs.sh then the
contents of the file are simply copied to the output.  All of the output
directives from directory scanning and file contents copying are
processed by usr/gen_init_cpio.”…””}”(hjÚ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KFhjo  hžhubh¸)”}”(hŒ#See also 'usr/gen_initramfs.sh -h'.”h]”hŒ'See also â€˜usr/gen_initramfs.sh -hâ€™.”…””}”(hjè  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KRhjo  hžhubh¢)”}”(hhh]”(h§)”}”(hŒWhere's this all leading?”h]”hŒWhereâ€™s this all leading?”…””}”(hjù  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjö  hžhhŸh¶h KUubh¸)”}”(hŒªThe klibc distribution contains some of the necessary software to make
early userspace useful.  The klibc distribution is currently
maintained separately from the kernel.”h]”hŒªThe klibc distribution contains some of the necessary software to make
early userspace useful.  The klibc distribution is currently
maintained separately from the kernel.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KWhjö  hžhubh¸)”}”(hŒgYou can obtain somewhat infrequent snapshots of klibc from
https://www.kernel.org/pub/linux/libs/klibc/”h]”(hŒ;You can obtain somewhat infrequent snapshots of klibc from
”…””}”(hj  hžhhŸNh NubhŒ	reference”“”)”}”(hŒ,https://www.kernel.org/pub/linux/libs/klibc/”h]”hŒ,https://www.kernel.org/pub/linux/libs/klibc/”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j!  uh1j  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K[hjö  hžhubh¸)”}”(hŒvFor active users, you are better off using the klibc git
repository, at https://git.kernel.org/?p=libs/klibc/klibc.git”h]”(hŒHFor active users, you are better off using the klibc git
repository, at ”…””}”(hj4  hžhhŸNh Nubj  )”}”(hŒ.https://git.kernel.org/?p=libs/klibc/klibc.git”h]”hŒ.https://git.kernel.org/?p=libs/klibc/klibc.git”…””}”(hj<  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j>  uh1j  hj4  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K^hjö  hžhubh¸)”}”(hŒhThe standalone klibc distribution currently provides three components,
in addition to the klibc library:”h]”hŒhThe standalone klibc distribution currently provides three components,
in addition to the klibc library:”…””}”(hjQ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kahjö  hžhubhä)”}”(hhh]”(hé)”}”(hŒ¦ipconfig, a program that configures network interfaces.  It can
configure them statically, or use DHCP to obtain information
dynamically (aka "IP autoconfiguration").”h]”h¸)”}”(hŒ¦ipconfig, a program that configures network interfaces.  It can
configure them statically, or use DHCP to obtain information
dynamically (aka "IP autoconfiguration").”h]”hŒªipconfig, a program that configures network interfaces.  It can
configure them statically, or use DHCP to obtain information
dynamically (aka â€œIP autoconfigurationâ€).”…””}”(hjf  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kdhjb  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhj_  hžhhŸh¶h Nubhé)”}”(hŒ5nfsmount, a program that can mount an NFS filesystem.”h]”h¸)”}”(hj|  h]”hŒ5nfsmount, a program that can mount an NFS filesystem.”…””}”(hj~  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kghjz  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhj_  hžhhŸh¶h Nubhé)”}”(hŒµkinit, the "glue" that uses ipconfig and nfsmount to replace the old
support for IP autoconfig, mount a filesystem over NFS, and continue
system boot using that filesystem as root.
”h]”h¸)”}”(hŒ´kinit, the "glue" that uses ipconfig and nfsmount to replace the old
support for IP autoconfig, mount a filesystem over NFS, and continue
system boot using that filesystem as root.”h]”hŒ¸kinit, the â€œglueâ€ that uses ipconfig and nfsmount to replace the old
support for IP autoconfig, mount a filesystem over NFS, and continue
system boot using that filesystem as root.”…””}”(hj•  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khhj‘  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhj_  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”j8  j9  uh1hãhŸh¶h Kdhjö  hžhubh¸)”}”(hŒBkinit is built as a single statically linked binary to save space.”h]”hŒBkinit is built as a single statically linked binary to save space.”…””}”(hj¯  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Klhjö  hžhubh¸)”}”(hŒ_Eventually, several more chunks of kernel functionality will hopefully
move to early userspace:”h]”hŒ_Eventually, several more chunks of kernel functionality will hopefully
move to early userspace:”…””}”(hj½  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Knhjö  hžhubhä)”}”(hhh]”(hé)”}”(hŒIAlmost all of init/do_mounts* (the beginning of this is already in
place)”h]”h¸)”}”(hŒIAlmost all of init/do_mounts* (the beginning of this is already in
place)”h]”hŒIAlmost all of init/do_mounts* (the beginning of this is already in
place)”…””}”(hjÒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KqhjÎ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjË  hžhhŸh¶h Nubhé)”}”(hŒACPI table parsing”h]”h¸)”}”(hjè  h]”hŒACPI table parsing”…””}”(hjê  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kshjæ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjË  hžhhŸh¶h Nubhé)”}”(hŒNInsert unwieldy subsystem that doesn't really need to be in kernel
space here
”h]”h¸)”}”(hŒMInsert unwieldy subsystem that doesn't really need to be in kernel
space here”h]”hŒOInsert unwieldy subsystem that doesnâ€™t really need to be in kernel
space here”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kthjý  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjË  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”j8  j9  uh1hãhŸh¶h Kqhjö  hžhubh¸)”}”(hX  If kinit doesn't meet your current needs and you've got bytes to burn,
the klibc distribution includes a small Bourne-compatible shell (ash)
and a number of other utilities, so you can replace kinit and build
custom initramfs images that meet your needs exactly.”h]”hX
  If kinit doesnâ€™t meet your current needs and youâ€™ve got bytes to burn,
the klibc distribution includes a small Bourne-compatible shell (ash)
and a number of other utilities, so you can replace kinit and build
custom initramfs images that meet your needs exactly.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kwhjö  hžhubh¸)”}”(hŒ|For questions and help, you can sign up for the early userspace
mailing list at https://www.zytor.com/mailman/listinfo/klibc”h]”(hŒPFor questions and help, you can sign up for the early userspace
mailing list at ”…””}”(hj)  hžhhŸNh Nubj  )”}”(hŒ,https://www.zytor.com/mailman/listinfo/klibc”h]”hŒ,https://www.zytor.com/mailman/listinfo/klibc”…””}”(hj1  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j3  uh1j  hj)  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K|hjö  hžhubeh}”(h]”Œwhere-s-this-all-leading”ah ]”h"]”Œwhere's this all leading?”ah$]”h&]”uh1h¡hjo  hžhhŸh¶h KUubh¢)”}”(hhh]”(h§)”}”(hŒHow does it work?”h]”hŒHow does it work?”…””}”(hjQ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjN  hžhhŸh¶h K€ubh¸)”}”(hŒ=The kernel has currently 3 ways to mount the root filesystem:”h]”hŒ=The kernel has currently 3 ways to mount the root filesystem:”…””}”(hj_  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K‚hjN  hžhubhŒenumerated_list”“”)”}”(hhh]”(hé)”}”(hX  all required device and filesystem drivers compiled into the kernel, no
initrd.  init/main.c:init() will call prepare_namespace() to mount the
final root filesystem, based on the root= option and optional init= to run
some other init binary than listed at the end of init/main.c:init().
”h]”h¸)”}”(hX  all required device and filesystem drivers compiled into the kernel, no
initrd.  init/main.c:init() will call prepare_namespace() to mount the
final root filesystem, based on the root= option and optional init= to run
some other init binary than listed at the end of init/main.c:init().”h]”hX  all required device and filesystem drivers compiled into the kernel, no
initrd.  init/main.c:init() will call prepare_namespace() to mount the
final root filesystem, based on the root= option and optional init= to run
some other init binary than listed at the end of init/main.c:init().”…””}”(hjv  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K„hjr  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjo  hžhhŸh¶h Nubhé)”}”(hXK  some device and filesystem drivers built as modules and stored in an
initrd.  The initrd must contain a binary '/linuxrc' which is supposed to
load these driver modules.  It is also possible to mount the final root
filesystem via linuxrc and use the pivot_root syscall.  The initrd is
mounted and executed via prepare_namespace().
”h]”h¸)”}”(hXJ  some device and filesystem drivers built as modules and stored in an
initrd.  The initrd must contain a binary '/linuxrc' which is supposed to
load these driver modules.  It is also possible to mount the final root
filesystem via linuxrc and use the pivot_root syscall.  The initrd is
mounted and executed via prepare_namespace().”h]”hXN  some device and filesystem drivers built as modules and stored in an
initrd.  The initrd must contain a binary â€˜/linuxrcâ€™ which is supposed to
load these driver modules.  It is also possible to mount the final root
filesystem via linuxrc and use the pivot_root syscall.  The initrd is
mounted and executed via prepare_namespace().”…””}”(hjŽ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K‰hjŠ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjo  hžhhŸh¶h Nubhé)”}”(hX_  using initramfs.  The call to prepare_namespace() must be skipped.
This means that a binary must do all the work.  Said binary can be stored
into initramfs either via modifying usr/gen_init_cpio.c or via the new
initrd format, an cpio archive.  It must be called "/init".  This binary
is responsible to do all the things prepare_namespace() would do.

To maintain backwards compatibility, the /init binary will only run if it
comes via an initramfs cpio archive.  If this is not the case,
init/main.c:init() will run prepare_namespace() to mount the final root
and exec one of the predefined init binaries.
”h]”(h¸)”}”(hX^  using initramfs.  The call to prepare_namespace() must be skipped.
This means that a binary must do all the work.  Said binary can be stored
into initramfs either via modifying usr/gen_init_cpio.c or via the new
initrd format, an cpio archive.  It must be called "/init".  This binary
is responsible to do all the things prepare_namespace() would do.”h]”hXb  using initramfs.  The call to prepare_namespace() must be skipped.
This means that a binary must do all the work.  Said binary can be stored
into initramfs either via modifying usr/gen_init_cpio.c or via the new
initrd format, an cpio archive.  It must be called â€œ/initâ€.  This binary
is responsible to do all the things prepare_namespace() would do.”…””}”(hj¦  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj¢  ubh¸)”}”(hŒþTo maintain backwards compatibility, the /init binary will only run if it
comes via an initramfs cpio archive.  If this is not the case,
init/main.c:init() will run prepare_namespace() to mount the final root
and exec one of the predefined init binaries.”h]”hŒþTo maintain backwards compatibility, the /init binary will only run if it
comes via an initramfs cpio archive.  If this is not the case,
init/main.c:init() will run prepare_namespace() to mount the final root
and exec one of the predefined init binaries.”…””}”(hj´  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K•hj¢  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèhjo  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œ
loweralpha”Œprefix”hŒsuffix”Œ)”uh1jm  hjN  hžhhŸh¶h K„ubh¸)”}”(hŒ%Bryan O'Sullivan <bos@serpentine.com>”h]”(hŒBryan Oâ€™Sullivan <”…””}”(hjÓ  hžhhŸNh Nubj  )”}”(hŒbos@serpentine.com”h]”hŒbos@serpentine.com”…””}”(hjÛ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:bos@serpentine.com”uh1j  hjÓ  ubhŒ>”…””}”(hjÓ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KšhjN  hžhubeh}”(h]”Œhow-does-it-work”ah ]”h"]”Œhow does it work?”ah$]”h&]”uh1h¡hjo  hžhhŸh¶h K€ubeh}”(h]”Œimage-building-method”ah ]”h"]”Œimage building method”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K'ubeh}”(h]”Œearly-userspace-support”ah ]”h"]”Œearly userspace support”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j0  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j
  j  jl  ji  j  jÿ  jK  jH  jú  j÷  uŒ	nametypes”}”(j
  ‰jl  ‰j  ‰jK  ‰jú  ‰uh}”(j  h£ji  jH  jÿ  jo  jH  jö  j÷  jN  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.