ref-manual: Document USE_DEVFS variable
PATCH 1/2 ref-manual: Document USE_DEVFS variable
--- documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+)
documentation/ref-manual/ref-variables.xml +17 -0
@@ -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."
Signature · 1 line
1.7.10.4
PATCH 2/2 dev-manual: Add section about /dev population
--- .../dev-manual/dev-manual-common-tasks.xml | 104 ++++++++++++++++++++ 1 file changed, 104 insertions(+)
documentation/dev-manual/dev-manual-common-tasks.xml +104 -0
@@ -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>
Signature · 1 line
1.7.10.4
Re: [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population
Quoted 10 lines · Pascal Bach
Signed-off-by Pascal Bach <[email protected]>--- .../dev-manual/dev-manual-common-tasks.xml | 104 ++++++++++++++++++++ 1 file changed, 104 insertions(+)documentation/dev-manual/dev-manual-common-tasks.xml +0
-0
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis> · line 7589
Quoted 8 lines
documentation/dev-manual/dev-manual-common-tasks.xml +5
-0@@ -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.
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis> · line 7592
Quoted 3 lines
documentation/dev-manual/dev-manual-common-tasks.xml +3
-0+ <itemizedlist> + <listitem><para> + <emphasis>Persistent and pre populated <filename>/dev</filename>:</emphasis>
^ hyphenate
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis> · line 7598
Quoted 6 lines
documentation/dev-manual/dev-manual-common-tasks.xml +6
-0+ 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
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis> · line 7600
Quoted 2 lines
documentation/dev-manual/dev-manual-common-tasks.xml +2
-0+ in this case the <filename>/dev</filename> directory is provided + by the kernel as an in memory file system and is automatically
^ hyphenate
Quoted 35 lines
documentation/dev-manual/dev-manual-common-tasks.xml +35
-0+ 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
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis> · line 7645
Quoted 10 lines
documentation/dev-manual/dev-manual-common-tasks.xml +10
-0+ during image creation. + + <literallayout class='monospaced'> + IMAGE_DEVICE_TABLES = "device_table-mymachine.txt" + </literallayout> + + </para> + </section> + + <section id="devtmps-dev-management">
^^^^^^^ devtmpfs
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis> · line 7657
Quoted 12 lines
documentation/dev-manual/dev-manual-common-tasks.xml +12
-0+ <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.
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis> · line 7660
Quoted 3 lines
documentation/dev-manual/dev-manual-common-tasks.xml +3
-0+ using <filename>devtmpfs</filename>. Make sure the corresponding + kernel configuration variable <filename>CONFIG_DEVTMPFS</filename> is set + when building a linux kernel.
^^^^^ Linux (capitalize)
Quoted 20 lines
documentation/dev-manual/dev-manual-common-tasks.xml +20
-0+ + </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" +
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis> · line 7690
Quoted 10 lines
documentation/dev-manual/dev-manual-common-tasks.xml +8
-0+ # 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
Signature · 7 lines
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================Rifenbark, Scott M
AppliedRe: [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population
In reply to Pascal BachPascal,
I have applied this patch with some editing. Also, applied the patch that added the USE_DEVFS variable to the ref-manual.
Thanks,
Scott
Quoted 161 lines
-----Original Message-----
From: [email protected] [mailto:yocto- [email protected]] On Behalf Of Pascal Bach
Sent: Wednesday, January 07, 2015 6:58 AM
To: [email protected]
Subject: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev populationSigned-off-by Pascal Bach <[email protected]>---
.../dev-manual/dev-manual-common-tasks.xml| 104
++++++++++++++++++++1 file changed, 104 insertions(+)documentation/dev-manual/dev-manual-common-tasks.xml +0
-0@@ -7582,6 +7582,110 @@ Gateways via their WebInterfaces</ulink>"</emphasis>
</section> </section>documentation/dev-manual/dev-manual-common-tasks.xml +8
-0+ <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>
documentation/dev-manual/dev-manual-common-tasks.xml +6
-0+ 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 devicemanager:</emphasis>
documentation/dev-manual/dev-manual-common-tasks.xml +5
-0+ 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>.
documentation/dev-manual/dev-manual-common-tasks.xml +6
-0+ </para></listitem> + </itemizedlist> + </para> + + <section id="static-dev-management"> + <title>Use Persistent and pre-populated<filename>/dev</filename></title>
documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ + <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>
documentation/dev-manual/dev-manual-common-tasks.xml +10
-0+ 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 bythe 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>documentation/dev-manual/dev-manual-common-tasks.xml +5
-0+ or <filename>local.conf</filename> configuration file. + </para> + + <para> + If nothing is defined the default <filename>device_table-minimal.txt</filename> is used.
documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ </para> + + <para> + The population is handled by the <filename>makedevs</filename>utility
documentation/dev-manual/dev-manual-common-tasks.xml +11
-0+ 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 devicemanager</title>
documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ + <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>
documentation/dev-manual/dev-manual-common-tasks.xml +7
-0+ 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 bythe kernel
+ using <filename>devtmpfs</filename>. Make sure the
corresponding
+ kernel configuration variable
<filename>CONFIG_DEVTMPFS</filename> is setdocumentation/dev-manual/dev-manual-common-tasks.xml +6
-0+ 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>.
documentation/dev-manual/dev-manual-common-tasks.xml +3
-0+ + To have more control over the device nodes a device manager like + <filename>udev</filename> or <filename>busybox-mdev</filename>
documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ can be used. + + The device manager to use is defined by the variable + <filename>VIRTUAL-RUNTIME_dev_manager</filename> andshould 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>documentation/dev-manual/dev-manual-common-tasks.xml +14
-1+ 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
[email protected]
https://lists.yoctoproject.org/listinfo/yocto
Re: [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.
Pascal
Quoted 194 lines
-----Original Message-----
From: Rifenbark, Scott M [mailto:[email protected]]
Sent: Samstag, 17. Januar 2015 01:05
To: Bach, Pascal; [email protected]
Subject: RE: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev populationPascal,
I have applied this patch with some editing. Also, applied the patch that added the
USE_DEVFSvariable to the ref-manual.Thanks,
ScottQuoted 24 lines
-----Original Message-----
From: [email protected] [mailto:yocto- [email protected]] On Behalf Of Pascal Bach
Sent: Wednesday, January 07, 2015 6:58 AM
To: [email protected]
Subject: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev populationSigned-off-by Pascal Bach <[email protected]>---
.../dev-manual/dev-manual-common-tasks.xml| 104
++++++++++++++++++++1 file changed, 104 insertions(+)documentation/dev-manual/dev-manual-common-tasks.xml +0
-0@@ -7582,6 +7582,110 @@ Gateways via their WebInterfaces</ulink>"</emphasis>
</section> </section>documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 5 lines
documentation/dev-manual/dev-manual-common-tasks.xml +5
-0+ <section id="selecting-dev-manager"> + <title>Selecting a Device Manager</title> + + <para> + Yocto provides multiple ways to manage<filename>/dev</filename>
Quoted 5 lines
documentation/dev-manual/dev-manual-common-tasks.xml +3
-0+ <itemizedlist> + <listitem><para> + <emphasis>Persistent and pre populated<filename>/dev</filename>:</emphasis>
+ in this case the <filename>/dev</filename> directoryis persistent
Quoted 1 line
+ and the required device nodes are created at build
time.
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 4 lines
documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ </para></listitem> + + <listitem><para> + <emphasis>Use <filename>devtmps</filename> with adevice
Quoted 2 lines
manager:</emphasis>
+ in this case the <filename>/dev</filename> directoryis provided
Quoted 1 line
+ by the kernel as an in memory file system and is
automatically
Quoted 1 line
+ populated by the kernel at runtime. Additional
configuration of
Quoted 1 line
+ device nodes is done in user space by a device manager
like
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 12 lines
+ <filename>udev</filename> or <filename>busybox-
mdev</filename>.documentation/dev-manual/dev-manual-common-tasks.xml +6
-0+ </para></listitem> + </itemizedlist> + </para> + + <section id="static-dev-management"> + <title>Use Persistent and pre-populated<filename>/dev</filename></title>
documentation/dev-manual/dev-manual-common-tasks.xml +3
-0+ + <para> + To use the static method for device population thevariable
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 11 lines
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-
USE_DEVFS'><filename>USE_DEVFS</filename></ulink>documentation/dev-manual/dev-manual-common-tasks.xml +9
-0+ needs to be set to 0. + + <literallayout class='monospaced'> + USE_DEVFS = "0" + </literallayout> + </para> + + <para> + The content of the resulting <filename>/dev</filename>directory
Quoted 1 line
+ is defined in a Device Table file. The device table to
use is defined by
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 13 lines
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>documentation/dev-manual/dev-manual-common-tasks.xml +5
-0+ or <filename>local.conf</filename> configuration file. + </para> + + <para> + If nothing is defined the default<filename>device_table-
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 5 lines
minimal.txt</filename> is used.
documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ </para> + + <para> + The population is handled by the<filename>makedevs</filename>
Quoted 13 lines
utility
documentation/dev-manual/dev-manual-common-tasks.xml +11
-0+ 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 devicemanager</title>
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 3 lines
documentation/dev-manual/dev-manual-common-tasks.xml +3
-0+ + <para> + To use the dynamic method for device population thevariable
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 9 lines
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-
USE_DEVFS'><filename>USE_DEVFS</filename></ulink>documentation/dev-manual/dev-manual-common-tasks.xml +7
-0+ needs to be set to 1. This is the default. + + <literallayout class='monospaced'> + USE_DEVFS = "1" + </literallayout> + + This way the resulting <filename>/dev</filename> ispopulated by
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 10 lines
the kernel
+ using <filename>devtmpfs</filename>. Make sure the
corresponding
+ kernel configuration variable
<filename>CONFIG_DEVTMPFS</filename> is setdocumentation/dev-manual/dev-manual-common-tasks.xml +5
-0+ when building a linux kernel. + + </para> + <para> + All devices created by <filename>devtmpfs</filename>will be
Quoted 1 line
+ owned by <filename>root</filename> and have
permissions
documentation/dev-manual/dev-manual-common-tasks.xml
Quoted 3 lines
<filename>0600</filename>.
documentation/dev-manual/dev-manual-common-tasks.xml +2
-0+ + To have more control over the device nodes a devicemanager like
Quoted 36 lines
+ <filename>udev</filename> or <filename>busybox-
mdev</filename>documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ can be used. + + The device manager to use is defined by the variable + <filename>VIRTUAL-RUNTIME_dev_manager</filename> andshould 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>documentation/dev-manual/dev-manual-common-tasks.xml +14
-1+ 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
[email protected]
https://lists.yoctoproject.org/listinfo/yocto
Re: [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev population
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
Quoted 217 lines
-----Original Message-----
From: Bach, Pascal [mailto:[email protected]]
Sent: Monday, January 19, 2015 12:30 AM
To: Rifenbark, Scott M; [email protected]
Subject: RE: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev populationHi Scott
Thanks. I had a look at the commits and it looks like commit
7c6c7ac573f92bfc844977e0d7a97ca4aac9bc70also 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=7c6c7ac573f92bfc844977e0d7a97ca4aac9bc70Pascal
Quoted 94 lines
-----Original Message-----
From: Rifenbark, Scott M [mailto:[email protected]]
Sent: Samstag, 17. Januar 2015 01:05
To: Bach, Pascal; [email protected]
Subject: RE: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev populationPascal,
I have applied this patch with some editing. Also, applied the patch that added the
USE_DEVFSvariable to the ref-manual.Thanks,
ScottQuoted 24 lines
-----Original Message-----
From: [email protected] [mailto:yocto- [email protected]] On Behalf Of Pascal Bach
Sent: Wednesday, January 07, 2015 6:58 AM
To: [email protected]
Subject: [yocto] [yocto-docs][PATCH 2/2] dev-manual: Add section about /dev populationSigned-off-by Pascal Bach <[email protected]>---
.../dev-manual/dev-manual-common-tasks.xml| 104
++++++++++++++++++++1 file changed, 104 insertions(+)documentation/dev-manual/dev-manual-common-tasks.xml +0
-0@@ -7582,6 +7582,110 @@ Gateways via their WebInterfaces</ulink>"</emphasis>
</section> </section>documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 5 lines
documentation/dev-manual/dev-manual-common-tasks.xml +5
-0+ <section id="selecting-dev-manager"> + <title>Selecting a Device Manager</title> + + <para> + Yocto provides multiple ways to manage<filename>/dev</filename>
Quoted 5 lines
documentation/dev-manual/dev-manual-common-tasks.xml +3
-0+ <itemizedlist> + <listitem><para> + <emphasis>Persistent and pre populated<filename>/dev</filename>:</emphasis>
+ in this case the <filename>/dev</filename> directoryis persistent
Quoted 1 line
+ and the required device nodes are created at build
time.
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 4 lines
documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ </para></listitem> + + <listitem><para> + <emphasis>Use <filename>devtmps</filename> with adevice
Quoted 2 lines
manager:</emphasis>
+ in this case the <filename>/dev</filename> directoryis provided
Quoted 1 line
+ by the kernel as an in memory file system and is
automatically
Quoted 1 line
+ populated by the kernel at runtime. Additional
configuration of
Quoted 2 lines
+ device nodes is done in user space by a device
+ managerlike
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 12 lines
+ <filename>udev</filename> or <filename>busybox-
mdev</filename>.documentation/dev-manual/dev-manual-common-tasks.xml +6
-0+ </para></listitem> + </itemizedlist> + </para> + + <section id="static-dev-management"> + <title>Use Persistent and pre-populated<filename>/dev</filename></title>
documentation/dev-manual/dev-manual-common-tasks.xml +3
-0+ + <para> + To use the static method for device population thevariable
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 12 lines
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-
USE_DEVFS'><filename>USE_DEVFS</filename></ulink>documentation/dev-manual/dev-manual-common-tasks.xml +10
-0+ needs to be set to 0. + + <literallayout class='monospaced'> + USE_DEVFS = "0" + </literallayout> + </para> + + <para> + The content of the resulting + <filename>/dev</filename>directory
Quoted 7 lines
Quoted 2 lines
+ is defined in a Device Table file. The device table
+ touse is defined by
Quoted 2 lines
the variable
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-IMAGE_DEVICE_TABLES'><filename>IMAGE_DEVICE_TABLES</filename></
ul
Quoted 97 lines
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 10 lines
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>documentation/dev-manual/dev-manual-common-tasks.xml +5
-0+ or <filename>local.conf</filename> configuration file. + </para> + + <para> + If nothing is defined the default<filename>device_table-
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 5 lines
minimal.txt</filename> is used.
documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ </para> + + <para> + The population is handled by the<filename>makedevs</filename>
Quoted 13 lines
utility
documentation/dev-manual/dev-manual-common-tasks.xml +11
-0+ 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 devicemanager</title>
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 3 lines
documentation/dev-manual/dev-manual-common-tasks.xml +3
-0+ + <para> + To use the dynamic method for device population thevariable
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 9 lines
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-
USE_DEVFS'><filename>USE_DEVFS</filename></ulink>documentation/dev-manual/dev-manual-common-tasks.xml +7
-0+ needs to be set to 1. This is the default. + + <literallayout class='monospaced'> + USE_DEVFS = "1" + </literallayout> + + This way the resulting <filename>/dev</filename> ispopulated by
documentation/dev-manual/dev-manual-common-tasks.xml Gateways via their Web Interfaces</ulink>"</emphasis>
Quoted 10 lines
the kernel
+ using <filename>devtmpfs</filename>. Make sure the
corresponding
+ kernel configuration variable
<filename>CONFIG_DEVTMPFS</filename> is setdocumentation/dev-manual/dev-manual-common-tasks.xml +5
-0+ when building a linux kernel. + + </para> + <para> + All devices created by <filename>devtmpfs</filename>will be
Quoted 1 line
+ owned by <filename>root</filename> and have
permissions
documentation/dev-manual/dev-manual-common-tasks.xml
Quoted 3 lines
<filename>0600</filename>.
documentation/dev-manual/dev-manual-common-tasks.xml +2
-0+ + To have more control over the device nodes a devicemanager like
Quoted 36 lines
+ <filename>udev</filename> or <filename>busybox-
mdev</filename>documentation/dev-manual/dev-manual-common-tasks.xml +4
-0+ can be used. + + The device manager to use is defined by the variable + <filename>VIRTUAL-RUNTIME_dev_manager</filename> andshould 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>documentation/dev-manual/dev-manual-common-tasks.xml +14
-1+ 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
[email protected]
https://lists.yoctoproject.org/listinfo/yocto
Quoted 10 lines · Pascal Bach
Signed-off-by Pascal Bach <[email protected]>--- documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+)documentation/ref-manual/ref-variables.xml +0
-0
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" · line 11204
Quoted 6 lines
documentation/ref-manual/ref-variables.xml +3
-0@@ -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
Signature · 7 lines
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================Quoted 16 lines
Review
Quoted 7 lines
Signed-off-by Pascal Bach <[email protected]>--- documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+)(quoted diff) +0
-0
b/documentation/ref-manual/ref-variables.xmldocumentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-
Quoted 4 lines
index e3272fe..7907220 100644
documentation/ref-manual/ref-variables.xml +0
-0@@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
Quoted 3 lines
documentation/ref-manual/ref-variables.xml +0
-0</glossdef> </glossentry>
Quoted 7 lines
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font- · line 11202
Quoted 1 line
documentation/ref-manual/ref-variables.xml +1
-0+ <glossentry id='var-USE_DEVFS'><glossterm><imagedatafileref="figures/define-generic.png" />USE_DEVFS</glossterm>
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font- · line 11204
Quoted 2 lines
documentation/ref-manual/ref-variables.xml +2
-0+ <info> + USE_DEVFS[doc] = "Determines if devtmps is used for/devpopulation."
^^^^^^^ ??
Sorry I don' t understand what you mean. Could you please elaborate?
Thanks
Pascal
Quoted 17 lines · Pascal
Quoted 17 lines
Review
Quoted 7 lines
Signed-off-by Pascal Bach <[email protected]>--- documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+)(quoted diff) +0
-0
b/documentation/ref-manual/ref-variables.xmldocumentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-
Quoted 4 lines
index e3272fe..7907220 100644
documentation/ref-manual/ref-variables.xml +0
-0@@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
Quoted 4 lines
documentation/ref-manual/ref-variables.xml +1
-0</glossdef> </glossentry> + <glossentry id='var-USE_DEVFS'><glossterm><imagedata
Quoted 8 lines
Quoted 6 lines
fileref="figures/define-generic.png" />USE_DEVFS</glossterm>
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font- · line 11204
Quoted 2 lines
documentation/ref-manual/ref-variables.xml +2
-0+ <info> + USE_DEVFS[doc] = "Determines if devtmps is used for/devpopulation."
^^^^^^^ ??Sorry I don' t understand what you mean. Could you please elaborate?
should that not say "devtmpfs", not "devtmps"?
rday
Signature · 7 lines
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================Quoted 21 lines
Quoted 4 lines
Quoted 4 lines
Quoted 4 lines
Signed-off-by Pascal Bach <[email protected]>--- documentation/ref-manual/ref-variables.xml | 17+++++++++++++++++
Quoted 16 lines
Quoted 16 lines
Review
Quoted 3 lines
1 file changed, 17 insertions(+)(quoted diff) +0
-0
b/documentation/ref-manual/ref-variables.xmldocumentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-
Quoted 4 lines
index e3272fe..7907220 100644
documentation/ref-manual/ref-variables.xml +0
-0@@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
Quoted 4 lines
documentation/ref-manual/ref-variables.xml +1
-0</glossdef> </glossentry> + <glossentry id='var-USE_DEVFS'><glossterm><imagedatafileref="figures/define-generic.png" />USE_DEVFS</glossterm>
Quoted 2 lines
documentation/ref-manual/ref-variables.xml +2
-0+ <info> + USE_DEVFS[doc] = "Determines if devtmps is used for/dev
Quoted 8 lines
Quoted 5 lines
Quoted 3 lines
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
Quoted 25 lines · Pascal
Quoted 25 lines
Quoted 4 lines
Quoted 4 lines
Quoted 4 lines
Signed-off-by Pascal Bach <[email protected]>--- documentation/ref-manual/ref-variables.xml | 17+++++++++++++++++
Quoted 20 lines
Quoted 19 lines
Review
Quoted 3 lines
1 file changed, 17 insertions(+)(quoted diff) +0
-0
b/documentation/ref-manual/ref-variables.xmldocumentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-
Quoted 4 lines
index e3272fe..7907220 100644
documentation/ref-manual/ref-variables.xml +0
-0@@ -11199,6 +11199,23 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
Quoted 4 lines
documentation/ref-manual/ref-variables.xml +1
-0</glossdef> </glossentry> + <glossentry id='var-USE_DEVFS'><glossterm><imagedatafileref="figures/define-generic.png" />USE_DEVFS</glossterm>
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font- · line 11204
Quoted 2 lines
documentation/ref-manual/ref-variables.xml +2
-0+ <info> + USE_DEVFS[doc] = "Determines if devtmps is used for/devpopulation."
^^^^^^^ ??
Quoted 8 lines
Quoted 4 lines
Quoted 1 line
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
Signature · 7 lines
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================Quoted 10 lines · Pascal Bach
Signed-off-by Pascal Bach <[email protected]>--- documentation/ref-manual/ref-variables.xml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+)documentation/ref-manual/ref-variables.xml +0
-0
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" · line 11204
Quoted 6 lines
documentation/ref-manual/ref-variables.xml +3
-0@@ -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
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" · line 11212
Quoted 8 lines
documentation/ref-manual/ref-variables.xml +8
-0+ </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
documentation/ref-manual/ref-variables.xml recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3" · line 11221
Quoted 9 lines
documentation/ref-manual/ref-variables.xml +6
-0+ 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
Signature · 7 lines
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================