* [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable
@ 2015-01-07 14:58 Pascal Bach
2015-01-07 14:58 ` [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population Pascal Bach
` (2 more replies)
0 siblings, 3 replies; 12+ messages in thread
From: Pascal Bach @ 2015-01-07 14:58 UTC (permalink / raw)
To: yocto
Signed-off-by: Pascal Bach <pascal.bach@siemens.com>
---
documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++
1 file changed, 17 insertions(+)
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index e3272fe..7907220 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
</glossdef>
</glossentry>
+ <glossentry id='var-USE_DEVFS'><glossterm><imagedata fileref="figures/define-generic.png" />USE_DEVFS</glossterm>
+ <info>
+ USE_DEVFS[doc] = "Determines if devtmps is used for/dev population."
+ </info>
+ <glossdef>
+ <para>
+ Determines if <filename>devtmpfs</filename> is used for <filename>/dev</filename> population.
+ The default value used for <filename>USE_DEVFS</filename>
+ is "1" when no default value is specifically set.
+ Typically, you would set <filename>USE_DEVFS</filename>
+ to "0" if you like to have a statically populated <filename>/dev</filename>
+ directory. See: <ulink url='&YOCTO_DOCS_DEV_URL;#selecting-dev-manager'>Development Manual</ulink>
+ for more information on <filename>/dev</filename> population.
+ </para>
+ </glossdef>
+ </glossentry>
+
<glossentry id='var-USE_VT'><glossterm><imagedata fileref="figures/define-generic.png" />USE_VT</glossterm>
<info>
USE_VT[doc] = "When using SysVinit, determines whether or not to run a getty on any virtual terminals in order to enable logging in through those terminals."
--
1.7.10.4
^ permalink raw reply related [flat|nested] 12+ messages in thread* [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population 2015-01-07 14:58 [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable Pascal Bach @ 2015-01-07 14:58 ` Pascal Bach 2015-01-07 15:15 ` Robert P. J. Day 2015-01-17 0:04 ` Rifenbark, Scott M 2015-01-07 15:01 ` [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable Robert P. J. Day 2015-01-07 15:09 ` Robert P. J. Day 2 siblings, 2 replies; 12+ messages in thread From: Pascal Bach @ 2015-01-07 14:58 UTC (permalink / raw) To: yocto Signed-off-by: Pascal Bach <pascal.bach@siemens.com> --- .../dev-manual/dev-manual-common-tasks.xml | 104 ++++++++++++++++++++ 1 file changed, 104 insertions(+) diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml index 17d725b..9072586 100644 --- a/documentation/dev-manual/dev-manual-common-tasks.xml +++ b/documentation/dev-manual/dev-manual-common-tasks.xml @@ -7582,6 +7582,110 @@ Gateways via their Web Interfaces</ulink>"</emphasis> </section> </section> + <section id="selecting-dev-manager"> + <title>Selecting a Device Manager</title> + + <para> + Yocto provides multiple ways to manage <filename>/dev</filename> + <itemizedlist> + <listitem><para> + <emphasis>Persistent and pre populated <filename>/dev</filename>:</emphasis> + in this case the <filename>/dev</filename> directory is persistent + and the required device nodes are created at build time. + </para></listitem> + + <listitem><para> + <emphasis>Use <filename>devtmps</filename> with a device manager:</emphasis> + in this case the <filename>/dev</filename> directory is provided + by the kernel as an in memory file system and is automatically + populated by the kernel at runtime. Additional configuration of + device nodes is done in user space by a device manager like + <filename>udev</filename> or <filename>busybox-mdev</filename>. + </para></listitem> + </itemizedlist> + </para> + + <section id="static-dev-management"> + <title>Use Persistent and pre-populated <filename>/dev</filename></title> + + <para> + To use the static method for device population the variable + <ulink url='&YOCTO_DOCS_REF_URL;#var-USE_DEVFS'><filename>USE_DEVFS</filename></ulink> + needs to be set to 0. + + <literallayout class='monospaced'> + USE_DEVFS = "0" + </literallayout> + </para> + + <para> + The content of the resulting <filename>/dev</filename> directory + is defined in a Device Table file. The device table to use is defined by the variable + <ulink url='&YOCTO_DOCS_REF_URL;#var-IMAGE_DEVICE_TABLES'><filename>IMAGE_DEVICE_TABLES</filename></ulink> and should be set + in the <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>, + <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO'><filename>DISTRO</filename></ulink> + or <filename>local.conf</filename> configuration file. + </para> + + <para> + If nothing is defined the default <filename>device_table-minimal.txt</filename> is used. + </para> + + <para> + The population is handled by the <filename>makedevs</filename> utility + during image creation. + + <literallayout class='monospaced'> + IMAGE_DEVICE_TABLES = "device_table-mymachine.txt" + </literallayout> + + </para> + </section> + + <section id="devtmps-dev-management"> + <title>Use <filename>devtmpfs</filename> and a device manager</title> + + <para> + To use the dynamic method for device population the variable + <ulink url='&YOCTO_DOCS_REF_URL;#var-USE_DEVFS'><filename>USE_DEVFS</filename></ulink> + needs to be set to 1. This is the default. + + <literallayout class='monospaced'> + USE_DEVFS = "1" + </literallayout> + + This way the resulting <filename>/dev</filename> is populated by the kernel + using <filename>devtmpfs</filename>. Make sure the corresponding + kernel configuration variable <filename>CONFIG_DEVTMPFS</filename> is set + when building a linux kernel. + + </para> + <para> + All devices created by <filename>devtmpfs</filename> will be + owned by <filename>root</filename> and have permissions <filename>0600</filename>. + + To have more control over the device nodes a device manager like + <filename>udev</filename> or <filename>busybox-mdev</filename> + can be used. + + The device manager to use is defined by the variable + <filename>VIRTUAL-RUNTIME_dev_manager</filename> and should be set + in the <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>, + <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO'><filename>DISTRO</filename></ulink> + or <filename>local.conf</filename> configuration file. + + <literallayout class='monospaced'> + + VIRTUAL-RUNTIME_dev_manager = "udev" + + # Some alternative values + # VIRTUAL-RUNTIME_dev_manager = "busybox-mdev" + # VIRTUAL-RUNTIME_dev_manager = "systemd" + </literallayout> + </para> + </section> + </section> + <section id="platdev-appdev-srcrev"> <title>Using an External SCM</title> -- 1.7.10.4 ^ permalink raw reply related [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population 2015-01-07 14:58 ` [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population Pascal Bach @ 2015-01-07 15:15 ` Robert P. J. Day 2015-01-17 0:04 ` Rifenbark, Scott M 1 sibling, 0 replies; 12+ messages in thread From: Robert P. J. Day @ 2015-01-07 15:15 UTC (permalink / raw) To: Pascal Bach; +Cc: yocto On Wed, 7 Jan 2015, Pascal Bach wrote: > Signed-off-by: Pascal Bach <pascal.bach@siemens.com> > --- > .../dev-manual/dev-manual-common-tasks.xml | 104 ++++++++++++++++++++ > 1 file changed, 104 insertions(+) > > diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml > index 17d725b..9072586 100644 > --- a/documentation/dev-manual/dev-manual-common-tasks.xml > +++ b/documentation/dev-manual/dev-manual-common-tasks.xml > @@ -7582,6 +7582,110 @@ Gateways via their Web Interfaces</ulink>"</emphasis> > </section> > </section> > > + <section id="selecting-dev-manager"> > + <title>Selecting a Device Manager</title> > + > + <para> > + Yocto provides multiple ways to manage <filename>/dev</filename> add a colon at the end of that line. > + <itemizedlist> > + <listitem><para> > + <emphasis>Persistent and pre populated <filename>/dev</filename>:</emphasis> ^ hyphenate > + in this case the <filename>/dev</filename> directory is persistent > + and the required device nodes are created at build time. > + </para></listitem> > + > + <listitem><para> > + <emphasis>Use <filename>devtmps</filename> with a device manager:</emphasis> ^^^^^^^ devtmpfs > + in this case the <filename>/dev</filename> directory is provided > + by the kernel as an in memory file system and is automatically ^ hyphenate > + populated by the kernel at runtime. Additional configuration of > + device nodes is done in user space by a device manager like > + <filename>udev</filename> or <filename>busybox-mdev</filename>. > + </para></listitem> > + </itemizedlist> > + </para> > + > + <section id="static-dev-management"> > + <title>Use Persistent and pre-populated <filename>/dev</filename></title> > + > + <para> > + To use the static method for device population the variable > + <ulink url='&YOCTO_DOCS_REF_URL;#var-USE_DEVFS'><filename>USE_DEVFS</filename></ulink> > + needs to be set to 0. > + > + <literallayout class='monospaced'> > + USE_DEVFS = "0" > + </literallayout> > + </para> > + > + <para> > + The content of the resulting <filename>/dev</filename> directory > + is defined in a Device Table file. The device table to use is defined by the variable > + <ulink url='&YOCTO_DOCS_REF_URL;#var-IMAGE_DEVICE_TABLES'><filename>IMAGE_DEVICE_TABLES</filename></ulink> and should be set > + in the <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>, > + <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO'><filename>DISTRO</filename></ulink> > + or <filename>local.conf</filename> configuration file. > + </para> > + > + <para> > + If nothing is defined the default <filename>device_table-minimal.txt</filename> is used. > + </para> > + > + <para> > + The population is handled by the <filename>makedevs</filename> utility > + during image creation. > + > + <literallayout class='monospaced'> > + IMAGE_DEVICE_TABLES = "device_table-mymachine.txt" > + </literallayout> > + > + </para> > + </section> > + > + <section id="devtmps-dev-management"> ^^^^^^^ devtmpfs > + <title>Use <filename>devtmpfs</filename> and a device manager</title> > + > + <para> > + To use the dynamic method for device population the variable > + <ulink url='&YOCTO_DOCS_REF_URL;#var-USE_DEVFS'><filename>USE_DEVFS</filename></ulink> > + needs to be set to 1. This is the default. > + > + <literallayout class='monospaced'> > + USE_DEVFS = "1" > + </literallayout> > + > + This way the resulting <filename>/dev</filename> is populated by the kernel i would add the word "directory" after /dev above. > + using <filename>devtmpfs</filename>. Make sure the corresponding > + kernel configuration variable <filename>CONFIG_DEVTMPFS</filename> is set > + when building a linux kernel. ^^^^^ Linux (capitalize) > + > + </para> > + <para> > + All devices created by <filename>devtmpfs</filename> will be > + owned by <filename>root</filename> and have permissions <filename>0600</filename>. > + > + To have more control over the device nodes a device manager like > + <filename>udev</filename> or <filename>busybox-mdev</filename> > + can be used. > + > + The device manager to use is defined by the variable > + <filename>VIRTUAL-RUNTIME_dev_manager</filename> and should be set > + in the <ulink url='&YOCTO_DOCS_REF_URL;#var-MACHINE'><filename>MACHINE</filename></ulink>, > + <ulink url='&YOCTO_DOCS_REF_URL;#var-DISTRO'><filename>DISTRO</filename></ulink> > + or <filename>local.conf</filename> configuration file. > + > + <literallayout class='monospaced'> > + > + VIRTUAL-RUNTIME_dev_manager = "udev" > + > + # Some alternative values > + # VIRTUAL-RUNTIME_dev_manager = "busybox-mdev" > + # VIRTUAL-RUNTIME_dev_manager = "systemd" > + </literallayout> > + </para> > + </section> > + </section> > + > <section id="platdev-appdev-srcrev"> > <title>Using an External SCM</title> rday -- ======================================================================== Robert P. J. Day Ottawa, Ontario, CANADA http://crashcourse.ca Twitter: http://twitter.com/rpjday LinkedIn: http://ca.linkedin.com/in/rpjday ======================================================================== ^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population 2015-01-07 14:58 ` [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population Pascal Bach 2015-01-07 15:15 ` Robert P. J. Day @ 2015-01-17 0:04 ` Rifenbark, Scott M 2015-01-19 8:30 ` Bach, Pascal 1 sibling, 1 reply; 12+ messages in thread From: Rifenbark, Scott M @ 2015-01-17 0:04 UTC (permalink / raw) To: Pascal Bach, yocto Pascal, I have applied this patch with some editing. Also, applied the patch that added the USE_DEVFS variable to the ref-manual. Thanks, Scott >-----Original Message----- >From: yocto-bounces@yoctoproject.org [mailto:yocto- >bounces@yoctoproject.org] On Behalf Of Pascal Bach >Sent: Wednesday, January 07, 2015 6:58 AM >To: yocto@yoctoproject.org >Subject: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section about >/dev population > >Signed-off-by: Pascal Bach <pascal.bach@siemens.com> >--- > .../dev-manual/dev-manual-common-tasks.xml | 104 >++++++++++++++++++++ > 1 file changed, 104 insertions(+) > >diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml >b/documentation/dev-manual/dev-manual-common-tasks.xml >index 17d725b..9072586 100644 >--- a/documentation/dev-manual/dev-manual-common-tasks.xml >+++ b/documentation/dev-manual/dev-manual-common-tasks.xml >@@ -7582,6 +7582,110 @@ Gateways via their Web >Interfaces</ulink>"</emphasis> > </section> > </section> > >+ <section id="selecting-dev-manager"> >+ <title>Selecting a Device Manager</title> >+ >+ <para> >+ Yocto provides multiple ways to manage <filename>/dev</filename> >+ <itemizedlist> >+ <listitem><para> >+ <emphasis>Persistent and pre populated ><filename>/dev</filename>:</emphasis> >+ in this case the <filename>/dev</filename> directory is persistent >+ and the required device nodes are created at build time. >+ </para></listitem> >+ >+ <listitem><para> >+ <emphasis>Use <filename>devtmps</filename> with a device >manager:</emphasis> >+ in this case the <filename>/dev</filename> directory is provided >+ by the kernel as an in memory file system and is automatically >+ populated by the kernel at runtime. Additional configuration of >+ device nodes is done in user space by a device manager like >+ <filename>udev</filename> or <filename>busybox- >mdev</filename>. >+ </para></listitem> >+ </itemizedlist> >+ </para> >+ >+ <section id="static-dev-management"> >+ <title>Use Persistent and pre-populated ><filename>/dev</filename></title> >+ >+ <para> >+ To use the static method for device population the variable >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >USE_DEVFS'><filename>USE_DEVFS</filename></ulink> >+ needs to be set to 0. >+ >+ <literallayout class='monospaced'> >+ USE_DEVFS = "0" >+ </literallayout> >+ </para> >+ >+ <para> >+ The content of the resulting <filename>/dev</filename> directory >+ is defined in a Device Table file. The device table to use is defined by >the variable >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >IMAGE_DEVICE_TABLES'><filename>IMAGE_DEVICE_TABLES</filename></ul >ink> and should be set >+ in the <ulink url='&YOCTO_DOCS_REF_URL;#var- >MACHINE'><filename>MACHINE</filename></ulink>, >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >DISTRO'><filename>DISTRO</filename></ulink> >+ or <filename>local.conf</filename> configuration file. >+ </para> >+ >+ <para> >+ If nothing is defined the default <filename>device_table- >minimal.txt</filename> is used. >+ </para> >+ >+ <para> >+ The population is handled by the <filename>makedevs</filename> >utility >+ during image creation. >+ >+ <literallayout class='monospaced'> >+ IMAGE_DEVICE_TABLES = "device_table-mymachine.txt" >+ </literallayout> >+ >+ </para> >+ </section> >+ >+ <section id="devtmps-dev-management"> >+ <title>Use <filename>devtmpfs</filename> and a device >manager</title> >+ >+ <para> >+ To use the dynamic method for device population the variable >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >USE_DEVFS'><filename>USE_DEVFS</filename></ulink> >+ needs to be set to 1. This is the default. >+ >+ <literallayout class='monospaced'> >+ USE_DEVFS = "1" >+ </literallayout> >+ >+ This way the resulting <filename>/dev</filename> is populated by >the kernel >+ using <filename>devtmpfs</filename>. Make sure the >corresponding >+ kernel configuration variable ><filename>CONFIG_DEVTMPFS</filename> is set >+ when building a linux kernel. >+ >+ </para> >+ <para> >+ All devices created by <filename>devtmpfs</filename> will be >+ owned by <filename>root</filename> and have permissions ><filename>0600</filename>. >+ >+ To have more control over the device nodes a device manager like >+ <filename>udev</filename> or <filename>busybox- >mdev</filename> >+ can be used. >+ >+ The device manager to use is defined by the variable >+ <filename>VIRTUAL-RUNTIME_dev_manager</filename> and >should be set >+ in the <ulink url='&YOCTO_DOCS_REF_URL;#var- >MACHINE'><filename>MACHINE</filename></ulink>, >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >DISTRO'><filename>DISTRO</filename></ulink> >+ or <filename>local.conf</filename> configuration file. >+ >+ <literallayout class='monospaced'> >+ >+ VIRTUAL-RUNTIME_dev_manager = "udev" >+ >+ # Some alternative values >+ # VIRTUAL-RUNTIME_dev_manager = "busybox-mdev" >+ # VIRTUAL-RUNTIME_dev_manager = "systemd" >+ </literallayout> >+ </para> >+ </section> >+ </section> >+ > <section id="platdev-appdev-srcrev"> > <title>Using an External SCM</title> > >-- >1.7.10.4 > >-- >_______________________________________________ >yocto mailing list >yocto@yoctoproject.org >https://lists.yoctoproject.org/listinfo/yocto ^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population 2015-01-17 0:04 ` Rifenbark, Scott M @ 2015-01-19 8:30 ` Bach, Pascal 2015-01-19 16:22 ` Rifenbark, Scott M 0 siblings, 1 reply; 12+ messages in thread From: Bach, Pascal @ 2015-01-19 8:30 UTC (permalink / raw) To: Rifenbark, Scott M, yocto Hi Scott Thanks. I had a look at the commits and it looks like commit 7c6c7ac573f92bfc844977e0d7a97ca4aac9bc70 also introduced a strange change on line 946 of dev-manual-common-tasks.xml. See: https://git.yoctoproject.org/cgit/cgit.cgi/yocto-docs/commit/?id=7c6c7ac573f92bfc844977e0d7a97ca4aac9bc70 Pascal > -----Original Message----- > From: Rifenbark, Scott M [mailto:scott.m.rifenbark@intel.com] > Sent: Samstag, 17. Januar 2015 01:05 > To: Bach, Pascal; yocto@yoctoproject.org > Subject: RE: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section > about /dev population > > Pascal, > > I have applied this patch with some editing. Also, applied the patch > that added the USE_DEVFS variable to the ref-manual. > > Thanks, > Scott > > >-----Original Message----- > >From: yocto-bounces@yoctoproject.org [mailto:yocto- > >bounces@yoctoproject.org] On Behalf Of Pascal Bach > >Sent: Wednesday, January 07, 2015 6:58 AM > >To: yocto@yoctoproject.org > >Subject: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section about > >/dev population > > > >Signed-off-by: Pascal Bach <pascal.bach@siemens.com> > >--- > > .../dev-manual/dev-manual-common-tasks.xml | 104 > >++++++++++++++++++++ > > 1 file changed, 104 insertions(+) > > > >diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml > >b/documentation/dev-manual/dev-manual-common-tasks.xml > >index 17d725b..9072586 100644 > >--- a/documentation/dev-manual/dev-manual-common-tasks.xml > >+++ b/documentation/dev-manual/dev-manual-common-tasks.xml > >@@ -7582,6 +7582,110 @@ Gateways via their Web > >Interfaces</ulink>"</emphasis> > > </section> > > </section> > > > >+ <section id="selecting-dev-manager"> > >+ <title>Selecting a Device Manager</title> > >+ > >+ <para> > >+ Yocto provides multiple ways to manage > <filename>/dev</filename> > >+ <itemizedlist> > >+ <listitem><para> > >+ <emphasis>Persistent and pre populated > ><filename>/dev</filename>:</emphasis> > >+ in this case the <filename>/dev</filename> directory > is persistent > >+ and the required device nodes are created at build > time. > >+ </para></listitem> > >+ > >+ <listitem><para> > >+ <emphasis>Use <filename>devtmps</filename> with a > device > >manager:</emphasis> > >+ in this case the <filename>/dev</filename> directory > is provided > >+ by the kernel as an in memory file system and is > automatically > >+ populated by the kernel at runtime. Additional > configuration of > >+ device nodes is done in user space by a device manager > like > >+ <filename>udev</filename> or <filename>busybox- > >mdev</filename>. > >+ </para></listitem> > >+ </itemizedlist> > >+ </para> > >+ > >+ <section id="static-dev-management"> > >+ <title>Use Persistent and pre-populated > ><filename>/dev</filename></title> > >+ > >+ <para> > >+ To use the static method for device population the > variable > >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- > >USE_DEVFS'><filename>USE_DEVFS</filename></ulink> > >+ needs to be set to 0. > >+ > >+ <literallayout class='monospaced'> > >+ USE_DEVFS = "0" > >+ </literallayout> > >+ </para> > >+ > >+ <para> > >+ The content of the resulting <filename>/dev</filename> > directory > >+ is defined in a Device Table file. The device table to > use is defined by > >the variable > >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- > >IMAGE_DEVICE_TABLES'><filename>IMAGE_DEVICE_TABLES</filename></ul > >ink> and should be set > >+ in the <ulink url='&YOCTO_DOCS_REF_URL;#var- > >MACHINE'><filename>MACHINE</filename></ulink>, > >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- > >DISTRO'><filename>DISTRO</filename></ulink> > >+ or <filename>local.conf</filename> configuration file. > >+ </para> > >+ > >+ <para> > >+ If nothing is defined the default > <filename>device_table- > >minimal.txt</filename> is used. > >+ </para> > >+ > >+ <para> > >+ The population is handled by the > <filename>makedevs</filename> > >utility > >+ during image creation. > >+ > >+ <literallayout class='monospaced'> > >+ IMAGE_DEVICE_TABLES = "device_table-mymachine.txt" > >+ </literallayout> > >+ > >+ </para> > >+ </section> > >+ > >+ <section id="devtmps-dev-management"> > >+ <title>Use <filename>devtmpfs</filename> and a device > >manager</title> > >+ > >+ <para> > >+ To use the dynamic method for device population the > variable > >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- > >USE_DEVFS'><filename>USE_DEVFS</filename></ulink> > >+ needs to be set to 1. This is the default. > >+ > >+ <literallayout class='monospaced'> > >+ USE_DEVFS = "1" > >+ </literallayout> > >+ > >+ This way the resulting <filename>/dev</filename> is > populated by > >the kernel > >+ using <filename>devtmpfs</filename>. Make sure the > >corresponding > >+ kernel configuration variable > ><filename>CONFIG_DEVTMPFS</filename> is set > >+ when building a linux kernel. > >+ > >+ </para> > >+ <para> > >+ All devices created by <filename>devtmpfs</filename> > will be > >+ owned by <filename>root</filename> and have > permissions > ><filename>0600</filename>. > >+ > >+ To have more control over the device nodes a device > manager like > >+ <filename>udev</filename> or <filename>busybox- > >mdev</filename> > >+ can be used. > >+ > >+ The device manager to use is defined by the variable > >+ <filename>VIRTUAL-RUNTIME_dev_manager</filename> and > >should be set > >+ in the <ulink url='&YOCTO_DOCS_REF_URL;#var- > >MACHINE'><filename>MACHINE</filename></ulink>, > >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- > >DISTRO'><filename>DISTRO</filename></ulink> > >+ or <filename>local.conf</filename> configuration file. > >+ > >+ <literallayout class='monospaced'> > >+ > >+ VIRTUAL-RUNTIME_dev_manager = "udev" > >+ > >+ # Some alternative values > >+ # VIRTUAL-RUNTIME_dev_manager = "busybox-mdev" > >+ # VIRTUAL-RUNTIME_dev_manager = "systemd" > >+ </literallayout> > >+ </para> > >+ </section> > >+ </section> > >+ > > <section id="platdev-appdev-srcrev"> > > <title>Using an External SCM</title> > > > >-- > >1.7.10.4 > > > >-- > >_______________________________________________ > >yocto mailing list > >yocto@yoctoproject.org > >https://lists.yoctoproject.org/listinfo/yocto ^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population 2015-01-19 8:30 ` Bach, Pascal @ 2015-01-19 16:22 ` Rifenbark, Scott M 0 siblings, 0 replies; 12+ messages in thread From: Rifenbark, Scott M @ 2015-01-19 16:22 UTC (permalink / raw) To: Bach, Pascal, yocto Pascal, Thanks for catching this. This was a result of cutting-and-pasting text in from the patch. I did not apply the patch in an automated fashion as there was some rewriting to do. So my hand-transposing missed those characters that were present in the email from which I was referencing. I removed them out and will republish the text later today. The commit to get them out is http://git.yoctoproject.org/cgit/cgit.cgi/yocto-docs/commit/?id=3ffbebd6c638e9f5b334dfef1d4e0bcc698ae810. Thanks, Scott >-----Original Message----- >From: Bach, Pascal [mailto:pascal.bach@siemens.com] >Sent: Monday, January 19, 2015 12:30 AM >To: Rifenbark, Scott M; yocto@yoctoproject.org >Subject: RE: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section about >/dev population > >Hi Scott > >Thanks. I had a look at the commits and it looks like commit >7c6c7ac573f92bfc844977e0d7a97ca4aac9bc70 also introduced a strange change >on line 946 of dev-manual-common-tasks.xml. > >See: https://git.yoctoproject.org/cgit/cgit.cgi/yocto- >docs/commit/?id=7c6c7ac573f92bfc844977e0d7a97ca4aac9bc70 > >Pascal > >> -----Original Message----- >> From: Rifenbark, Scott M [mailto:scott.m.rifenbark@intel.com] >> Sent: Samstag, 17. Januar 2015 01:05 >> To: Bach, Pascal; yocto@yoctoproject.org >> Subject: RE: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section >> about /dev population >> >> Pascal, >> >> I have applied this patch with some editing. Also, applied the patch >> that added the USE_DEVFS variable to the ref-manual. >> >> Thanks, >> Scott >> >> >-----Original Message----- >> >From: yocto-bounces@yoctoproject.org [mailto:yocto- >> >bounces@yoctoproject.org] On Behalf Of Pascal Bach >> >Sent: Wednesday, January 07, 2015 6:58 AM >> >To: yocto@yoctoproject.org >> >Subject: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section >> >about /dev population >> > >> >Signed-off-by: Pascal Bach <pascal.bach@siemens.com> >> >--- >> > .../dev-manual/dev-manual-common-tasks.xml | 104 >> >++++++++++++++++++++ >> > 1 file changed, 104 insertions(+) >> > >> >diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml >> >b/documentation/dev-manual/dev-manual-common-tasks.xml >> >index 17d725b..9072586 100644 >> >--- a/documentation/dev-manual/dev-manual-common-tasks.xml >> >+++ b/documentation/dev-manual/dev-manual-common-tasks.xml >> >@@ -7582,6 +7582,110 @@ Gateways via their Web >> >Interfaces</ulink>"</emphasis> >> > </section> >> > </section> >> > >> >+ <section id="selecting-dev-manager"> >> >+ <title>Selecting a Device Manager</title> >> >+ >> >+ <para> >> >+ Yocto provides multiple ways to manage >> <filename>/dev</filename> >> >+ <itemizedlist> >> >+ <listitem><para> >> >+ <emphasis>Persistent and pre populated >> ><filename>/dev</filename>:</emphasis> >> >+ in this case the <filename>/dev</filename> directory >> is persistent >> >+ and the required device nodes are created at build >> time. >> >+ </para></listitem> >> >+ >> >+ <listitem><para> >> >+ <emphasis>Use <filename>devtmps</filename> with a >> device >> >manager:</emphasis> >> >+ in this case the <filename>/dev</filename> directory >> is provided >> >+ by the kernel as an in memory file system and is >> automatically >> >+ populated by the kernel at runtime. Additional >> configuration of >> >+ device nodes is done in user space by a device >> >+ manager >> like >> >+ <filename>udev</filename> or <filename>busybox- >> >mdev</filename>. >> >+ </para></listitem> >> >+ </itemizedlist> >> >+ </para> >> >+ >> >+ <section id="static-dev-management"> >> >+ <title>Use Persistent and pre-populated >> ><filename>/dev</filename></title> >> >+ >> >+ <para> >> >+ To use the static method for device population the >> variable >> >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >> >USE_DEVFS'><filename>USE_DEVFS</filename></ulink> >> >+ needs to be set to 0. >> >+ >> >+ <literallayout class='monospaced'> >> >+ USE_DEVFS = "0" >> >+ </literallayout> >> >+ </para> >> >+ >> >+ <para> >> >+ The content of the resulting >> >+ <filename>/dev</filename> >> directory >> >+ is defined in a Device Table file. The device table >> >+ to >> use is defined by >> >the variable >> >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >> >>IMAGE_DEVICE_TABLES'><filename>IMAGE_DEVICE_TABLES</filename></ >ul >> >ink> and should be set >> >+ in the <ulink url='&YOCTO_DOCS_REF_URL;#var- >> >MACHINE'><filename>MACHINE</filename></ulink>, >> >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >> >DISTRO'><filename>DISTRO</filename></ulink> >> >+ or <filename>local.conf</filename> configuration file. >> >+ </para> >> >+ >> >+ <para> >> >+ If nothing is defined the default >> <filename>device_table- >> >minimal.txt</filename> is used. >> >+ </para> >> >+ >> >+ <para> >> >+ The population is handled by the >> <filename>makedevs</filename> >> >utility >> >+ during image creation. >> >+ >> >+ <literallayout class='monospaced'> >> >+ IMAGE_DEVICE_TABLES = "device_table-mymachine.txt" >> >+ </literallayout> >> >+ >> >+ </para> >> >+ </section> >> >+ >> >+ <section id="devtmps-dev-management"> >> >+ <title>Use <filename>devtmpfs</filename> and a device >> >manager</title> >> >+ >> >+ <para> >> >+ To use the dynamic method for device population the >> variable >> >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >> >USE_DEVFS'><filename>USE_DEVFS</filename></ulink> >> >+ needs to be set to 1. This is the default. >> >+ >> >+ <literallayout class='monospaced'> >> >+ USE_DEVFS = "1" >> >+ </literallayout> >> >+ >> >+ This way the resulting <filename>/dev</filename> is >> populated by >> >the kernel >> >+ using <filename>devtmpfs</filename>. Make sure the >> >corresponding >> >+ kernel configuration variable >> ><filename>CONFIG_DEVTMPFS</filename> is set >> >+ when building a linux kernel. >> >+ >> >+ </para> >> >+ <para> >> >+ All devices created by <filename>devtmpfs</filename> >> will be >> >+ owned by <filename>root</filename> and have >> permissions >> ><filename>0600</filename>. >> >+ >> >+ To have more control over the device nodes a device >> manager like >> >+ <filename>udev</filename> or <filename>busybox- >> >mdev</filename> >> >+ can be used. >> >+ >> >+ The device manager to use is defined by the variable >> >+ <filename>VIRTUAL-RUNTIME_dev_manager</filename> and >> >should be set >> >+ in the <ulink url='&YOCTO_DOCS_REF_URL;#var- >> >MACHINE'><filename>MACHINE</filename></ulink>, >> >+ <ulink url='&YOCTO_DOCS_REF_URL;#var- >> >DISTRO'><filename>DISTRO</filename></ulink> >> >+ or <filename>local.conf</filename> configuration file. >> >+ >> >+ <literallayout class='monospaced'> >> >+ >> >+ VIRTUAL-RUNTIME_dev_manager = "udev" >> >+ >> >+ # Some alternative values >> >+ # VIRTUAL-RUNTIME_dev_manager = "busybox-mdev" >> >+ # VIRTUAL-RUNTIME_dev_manager = "systemd" >> >+ </literallayout> >> >+ </para> >> >+ </section> >> >+ </section> >> >+ >> > <section id="platdev-appdev-srcrev"> >> > <title>Using an External SCM</title> >> > >> >-- >> >1.7.10.4 >> > >> >-- >> >_______________________________________________ >> >yocto mailing list >> >yocto@yoctoproject.org >> >https://lists.yoctoproject.org/listinfo/yocto ^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable 2015-01-07 14:58 [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable Pascal Bach 2015-01-07 14:58 ` [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population Pascal Bach @ 2015-01-07 15:01 ` Robert P. J. Day 2015-01-07 15:04 ` Bach, Pascal 2015-01-07 15:09 ` Robert P. J. Day 2 siblings, 1 reply; 12+ messages in thread From: Robert P. J. Day @ 2015-01-07 15:01 UTC (permalink / raw) To: Pascal Bach; +Cc: yocto On Wed, 7 Jan 2015, Pascal Bach wrote: > Signed-off-by: Pascal Bach <pascal.bach@siemens.com> > --- > documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++ > 1 file changed, 17 insertions(+) > > diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml > index e3272fe..7907220 100644 > --- a/documentation/ref-manual/ref-variables.xml > +++ b/documentation/ref-manual/ref-variables.xml > @@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" > </glossdef> > </glossentry> > > + <glossentry id='var-USE_DEVFS'><glossterm><imagedata fileref="figures/define-generic.png" />USE_DEVFS</glossterm> > + <info> > + USE_DEVFS[doc] = "Determines if devtmps is used for/dev population." ^^^^^^^ ?? rday -- ======================================================================== Robert P. J. Day Ottawa, Ontario, CANADA http://crashcourse.ca Twitter: http://twitter.com/rpjday LinkedIn: http://ca.linkedin.com/in/rpjday ======================================================================== ^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable 2015-01-07 15:01 ` [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable Robert P. J. Day @ 2015-01-07 15:04 ` Bach, Pascal 2015-01-07 15:07 ` Robert P. J. Day 0 siblings, 1 reply; 12+ messages in thread From: Bach, Pascal @ 2015-01-07 15:04 UTC (permalink / raw) To: Robert P. J. Day; +Cc: yocto > > > Signed-off-by: Pascal Bach <pascal.bach@siemens.com> > > --- > > documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++ > > 1 file changed, 17 insertions(+) > > > > diff --git a/documentation/ref-manual/ref-variables.xml > b/documentation/ref-manual/ref-variables.xml > > index e3272fe..7907220 100644 > > --- a/documentation/ref-manual/ref-variables.xml > > +++ b/documentation/ref-manual/ref-variables.xml > > @@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font- > alias_1.0.3.bb:PR = "${INC_PR}.3" > > </glossdef> > > </glossentry> > > > > + <glossentry id='var-USE_DEVFS'><glossterm><imagedata > fileref="figures/define-generic.png" />USE_DEVFS</glossterm> > > + <info> > > + USE_DEVFS[doc] = "Determines if devtmps is used for/dev > population." > ^^^^^^^ ?? > Sorry I don' t understand what you mean. Could you please elaborate? Thanks Pascal ^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable 2015-01-07 15:04 ` Bach, Pascal @ 2015-01-07 15:07 ` Robert P. J. Day 2015-01-07 15:10 ` Bach, Pascal 0 siblings, 1 reply; 12+ messages in thread From: Robert P. J. Day @ 2015-01-07 15:07 UTC (permalink / raw) To: Bach, Pascal; +Cc: yocto On Wed, 7 Jan 2015, Bach, Pascal wrote: > > > > > Signed-off-by: Pascal Bach <pascal.bach@siemens.com> > > > --- > > > documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++ > > > 1 file changed, 17 insertions(+) > > > > > > diff --git a/documentation/ref-manual/ref-variables.xml > > b/documentation/ref-manual/ref-variables.xml > > > index e3272fe..7907220 100644 > > > --- a/documentation/ref-manual/ref-variables.xml > > > +++ b/documentation/ref-manual/ref-variables.xml > > > @@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font- > > alias_1.0.3.bb:PR = "${INC_PR}.3" > > > </glossdef> > > > </glossentry> > > > > > > + <glossentry id='var-USE_DEVFS'><glossterm><imagedata > > fileref="figures/define-generic.png" />USE_DEVFS</glossterm> > > > + <info> > > > + USE_DEVFS[doc] = "Determines if devtmps is used for/dev > > population." > > ^^^^^^^ ?? > > > > Sorry I don' t understand what you mean. Could you please elaborate? should that not say "devtmpfs", not "devtmps"? rday -- ======================================================================== Robert P. J. Day Ottawa, Ontario, CANADA http://crashcourse.ca Twitter: http://twitter.com/rpjday LinkedIn: http://ca.linkedin.com/in/rpjday ======================================================================== ^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable 2015-01-07 15:07 ` Robert P. J. Day @ 2015-01-07 15:10 ` Bach, Pascal 2015-01-07 15:16 ` Robert P. J. Day 0 siblings, 1 reply; 12+ messages in thread From: Bach, Pascal @ 2015-01-07 15:10 UTC (permalink / raw) To: Robert P. J. Day; +Cc: yocto > > > > > > > Signed-off-by: Pascal Bach <pascal.bach@siemens.com> > > > > --- > > > > documentation/ref-manual/ref-variables.xml | 17 > +++++++++++++++++ > > > > 1 file changed, 17 insertions(+) > > > > > > > > diff --git a/documentation/ref-manual/ref-variables.xml > > > b/documentation/ref-manual/ref-variables.xml > > > > index e3272fe..7907220 100644 > > > > --- a/documentation/ref-manual/ref-variables.xml > > > > +++ b/documentation/ref-manual/ref-variables.xml > > > > @@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font- > > > alias_1.0.3.bb:PR = "${INC_PR}.3" > > > > </glossdef> > > > > </glossentry> > > > > > > > > + <glossentry id='var-USE_DEVFS'><glossterm><imagedata > > > fileref="figures/define-generic.png" />USE_DEVFS</glossterm> > > > > + <info> > > > > + USE_DEVFS[doc] = "Determines if devtmps is used for/dev > > > population." > > > ^^^^^^^ ?? > > > > > > > Sorry I don' t understand what you mean. Could you please elaborate? > > should that not say "devtmpfs", not "devtmps"? > Of course :) I didn't see it sorry even with you nice underlining ;). Thanks for pointing it out. Should I resubmit the patch or is it easier if the committing person fixes it? Pascal ^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable 2015-01-07 15:10 ` Bach, Pascal @ 2015-01-07 15:16 ` Robert P. J. Day 0 siblings, 0 replies; 12+ messages in thread From: Robert P. J. Day @ 2015-01-07 15:16 UTC (permalink / raw) To: Bach, Pascal; +Cc: yocto On Wed, 7 Jan 2015, Bach, Pascal wrote: > > > > > > > > > Signed-off-by: Pascal Bach <pascal.bach@siemens.com> > > > > > --- > > > > > documentation/ref-manual/ref-variables.xml | 17 > > +++++++++++++++++ > > > > > 1 file changed, 17 insertions(+) > > > > > > > > > > diff --git a/documentation/ref-manual/ref-variables.xml > > > > b/documentation/ref-manual/ref-variables.xml > > > > > index e3272fe..7907220 100644 > > > > > --- a/documentation/ref-manual/ref-variables.xml > > > > > +++ b/documentation/ref-manual/ref-variables.xml > > > > > @@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font- > > > > alias_1.0.3.bb:PR = "${INC_PR}.3" > > > > > </glossdef> > > > > > </glossentry> > > > > > > > > > > + <glossentry id='var-USE_DEVFS'><glossterm><imagedata > > > > fileref="figures/define-generic.png" />USE_DEVFS</glossterm> > > > > > + <info> > > > > > + USE_DEVFS[doc] = "Determines if devtmps is used for/dev > > > > population." > > > > ^^^^^^^ ?? > > > > > > > > > > Sorry I don' t understand what you mean. Could you please elaborate? > > > > should that not say "devtmpfs", not "devtmps"? > > > Of course :) > I didn't see it sorry even with you nice underlining ;). Thanks for pointing it out. > > Should I resubmit the patch or is it easier if the committing person fixes it? normally, just resubmit with [PATCH v2 ...] in the subject, unless someone like scott says he'll take it as is. rday -- ======================================================================== Robert P. J. Day Ottawa, Ontario, CANADA http://crashcourse.ca Twitter: http://twitter.com/rpjday LinkedIn: http://ca.linkedin.com/in/rpjday ======================================================================== ^ permalink raw reply [flat|nested] 12+ messages in thread
* Re: [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable 2015-01-07 14:58 [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable Pascal Bach 2015-01-07 14:58 ` [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population Pascal Bach 2015-01-07 15:01 ` [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable Robert P. J. Day @ 2015-01-07 15:09 ` Robert P. J. Day 2 siblings, 0 replies; 12+ messages in thread From: Robert P. J. Day @ 2015-01-07 15:09 UTC (permalink / raw) To: Pascal Bach; +Cc: yocto On Wed, 7 Jan 2015, Pascal Bach wrote: > Signed-off-by: Pascal Bach <pascal.bach@siemens.com> > --- > documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++ > 1 file changed, 17 insertions(+) > > diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml > index e3272fe..7907220 100644 > --- a/documentation/ref-manual/ref-variables.xml > +++ b/documentation/ref-manual/ref-variables.xml > @@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" > </glossdef> > </glossentry> > > + <glossentry id='var-USE_DEVFS'><glossterm><imagedata fileref="figures/define-generic.png" />USE_DEVFS</glossterm> > + <info> > + USE_DEVFS[doc] = "Determines if devtmps is used for/dev population." ^ space > + </info> > + <glossdef> > + <para> > + Determines if <filename>devtmpfs</filename> is used for <filename>/dev</filename> population. > + The default value used for <filename>USE_DEVFS</filename> > + is "1" when no default value is specifically set. > + Typically, you would set <filename>USE_DEVFS</filename> > + to "0" if you like to have a statically populated <filename>/dev</filename> ^ hyphenate > + directory. See: <ulink url='&YOCTO_DOCS_DEV_URL;#selecting-dev-manager'>Development Manual</ulink> > + for more information on <filename>/dev</filename> population. > + </para> > + </glossdef> > + </glossentry> > + > <glossentry id='var-USE_VT'><glossterm><imagedata fileref="figures/define-generic.png" />USE_VT</glossterm> > <info> > USE_VT[doc] = "When using SysVinit, determines whether or not to run a getty on any virtual terminals in order to enable logging in through those terminals." rday -- ======================================================================== Robert P. J. Day Ottawa, Ontario, CANADA http://crashcourse.ca Twitter: http://twitter.com/rpjday LinkedIn: http://ca.linkedin.com/in/rpjday ======================================================================== ^ permalink raw reply [flat|nested] 12+ messages in thread
end of thread, other threads:[~2015-01-19 16:22 UTC | newest] Thread overview: 12+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- 2015-01-07 14:58 [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable Pascal Bach 2015-01-07 14:58 ` [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population Pascal Bach 2015-01-07 15:15 ` Robert P. J. Day 2015-01-17 0:04 ` Rifenbark, Scott M 2015-01-19 8:30 ` Bach, Pascal 2015-01-19 16:22 ` Rifenbark, Scott M 2015-01-07 15:01 ` [yocto-docs][PATCH 1/2] ref-manual: Document USE_DEVFS variable Robert P. J. Day 2015-01-07 15:04 ` Bach, Pascal 2015-01-07 15:07 ` Robert P. J. Day 2015-01-07 15:10 ` Bach, Pascal 2015-01-07 15:16 ` Robert P. J. Day 2015-01-07 15:09 ` Robert P. J. Day
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.