kumquat-buildroot/docs/manual
Yann E. MORIN dc1ba281a5 docs/manual: makedevs only accepts numerical values
Because of a limitation in how makedevs resolves names [0], usernames
and groupnames would be resolved with UIDs and GIDs from the host, not
the target.

Fixing makedevs would involve us rewriting a /etc/passwd and /etc/group
parser (not too complex, still not trivial).

Document that the user and group fields should only be numbers, not
names. Also, the manual is currently misleading, as an example indeed
uses names for the user and group fields. Fix that and expand the
explanations.

The mode field should also be numbers, not a rwx combo.

Slight typographical eye-candy about major/minor fields.

[0] it uses getpwnma(3) and getgrnam(3) to resolve names to IDs, and
those only resolve names on the host (i.e. there is no way to specify
a chroot-like feature)

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2015-08-29 10:35:28 +02:00
..
adding-board-support.txt manual/developer guide: minor rework of 'adding board support' section 2014-09-21 19:41:12 +02:00
adding-packages-asciidoc.txt docs/manual: document the asciidoc infra 2014-10-12 07:46:28 +02:00
adding-packages-autotools.txt manual: Remove trailing space 2014-11-22 20:13:16 +01:00
adding-packages-cmake.txt pkg-cmake: allow to build package in a subdirectory 2015-03-13 22:34:43 +01:00
adding-packages-conclusion.txt
adding-packages-directory.txt docs/manual: document gcc version dependencies 2015-08-05 12:11:20 +02:00
adding-packages-generic.txt docs/manual: document <PKG>_STRIP_COMPONENTS 2015-07-12 00:51:14 +02:00
adding-packages-gettext.txt docs/manual: update documentation about gettext handling 2014-08-18 10:36:31 +02:00
adding-packages-hooks.txt
adding-packages-kconfig.txt kconfig-package: add support for config fragments 2015-05-21 23:41:46 +02:00
adding-packages-kernel-module.txt docs/manual: add documentation for linux-ext and linux-tools. 2015-07-14 23:35:58 +02:00
adding-packages-linux-kernel-spec-infra.txt docs/manual: add documentation for linux-ext and linux-tools. 2015-07-14 23:35:58 +02:00
adding-packages-luarocks.txt packages: rename FOO_BUILD_OPT into FOO_BUILD_OPTS 2014-10-04 18:54:30 +02:00
adding-packages-perl.txt packages: rename FOO_BUILD_OPT into FOO_BUILD_OPTS 2014-10-04 18:54:30 +02:00
adding-packages-python.txt docs/manual: Fix trivial typo 2015-07-14 23:56:58 +02:00
adding-packages-rebar.txt docs/manual: add documentation for the pkg-rebar infrastructure 2015-02-03 10:23:03 +01:00
adding-packages-tips.txt docs/manual: Modify GitHub FOO_SITE explanation 2015-07-28 23:37:39 +02:00
adding-packages-virtual.txt docs/manual: add the virtual packages list 2014-06-08 17:11:47 +02:00
adding-packages.txt docs/manual: add documentation for linux-ext and linux-tools. 2015-07-14 23:35:58 +02:00
advanced.txt manual: high-level restructuring 2014-08-17 21:09:52 +02:00
appendix.txt manual: high-level restructuring 2014-08-17 21:09:52 +02:00
beyond-buildroot.txt docs/manual/beyond-buildroot: additional minor fixes 2015-07-10 19:17:02 +02:00
ccache-support.txt manual: high-level restructuring 2014-08-17 21:09:52 +02:00
common-usage.txt docs/manual: document new graph-depends options 2015-04-01 00:00:07 +02:00
configure-other-components.txt docs/manual: add U-Boot configuration 2015-07-19 14:47:11 +02:00
configure.txt docs/manual: remove references to IPv6 2015-04-22 23:00:11 +02:00
contribute.txt manual: remove the extra whitespaces 2014-12-20 15:55:54 +01:00
customize-configuration.txt docs/manual: add U-Boot configuration 2015-07-19 14:47:11 +02:00
customize-device-permission-tables.txt manual: remove the extra whitespaces 2014-12-20 15:55:54 +01:00
customize-directory-structure.txt manual/user guide/customization: add section on layered customization 2014-09-21 19:41:12 +02:00
customize-outside-br.txt docs/manual/br2-external: use proper .Note sections 2015-05-25 22:35:10 +02:00
customize-packages.txt manual: remove the extra whitespaces 2014-12-20 15:55:54 +01:00
customize-patches.txt docs/manual: update documentation about applying patches 2015-04-06 11:05:16 +02:00
customize-post-image.txt manual/user guide/customization: rework section on rootfs customization 2014-08-31 22:22:43 +02:00
customize-quick-guide.txt docs/manual: add U-Boot configuration 2015-07-19 14:47:11 +02:00
customize-rootfs.txt manual/user guide/customization: refer to dir structure from rootfs section 2014-09-21 19:41:12 +02:00
customize-users-tables.txt manual/user guide/customization: add section on users tables 2014-09-21 19:41:12 +02:00
customize.txt manual/user guide/customization: rework 'step-by-step instructions' 2014-09-21 19:41:12 +02:00
debugging-buildroot.txt docs/manual: add list of instrumentation steps 2015-05-05 22:47:32 +02:00
download-infra.txt
download-location.txt manual: remove the extra whitespaces 2014-12-20 15:55:54 +01:00
eclipse-integration.txt manual/user guide: high-level restructuring 2014-08-21 15:39:32 +02:00
faq-troubleshooting.txt docs/manual: add FAQ entry about speeding up the build process 2015-02-03 15:15:27 +01:00
getting.txt manual/getting started: rework 'Getting Buildroot' section 2014-08-17 21:09:52 +02:00
how-buildroot-works.txt manual/user guide: high-level restructuring 2014-08-21 15:39:32 +02:00
introduction.txt manual: high-level restructuring 2014-08-17 21:09:52 +02:00
known-issues.txt manual: high-level restructuring 2014-08-17 21:09:52 +02:00
legal-notice.txt docs: add links to the rest of the licenses 2015-04-02 23:05:10 +02:00
make-tips.txt docs/manual: add U-Boot configuration 2015-07-19 14:47:11 +02:00
makedev-syntax.txt docs/manual: makedevs only accepts numerical values 2015-08-29 10:35:28 +02:00
makeusers-syntax.txt scripts/mkusers: allow users with no password value set 2015-06-09 23:13:41 +02:00
manual.mk doc/manual: fix generating manual after legacy overhaul 2015-05-02 09:00:44 +02:00
manual.txt manual: move 'Creating your own board support' from User to Developer guide 2014-09-21 19:41:12 +02:00
package-make-target.txt docs/manual: reinstall target 2015-02-03 18:08:32 +01:00
patch-policy.txt docs/manual: document the new patch naming convention 2014-12-07 21:32:01 +01:00
prerequisite.txt docs/manual: relax python version requirement 2015-07-14 23:56:35 +02:00
quickstart.txt manual: remove the extra whitespaces 2014-12-20 15:55:54 +01:00
rebuilding-packages.txt
resources.txt docs/manual/resources.txt: fix patchwork link 2014-11-13 23:53:14 +01:00
using-buildroot-debugger.txt manual: high-level restructuring 2014-08-17 21:09:52 +02:00
using-buildroot-development.txt manual: high-level restructuring 2014-08-17 21:09:52 +02:00
using-buildroot-toolchain.txt manual: remove the extra whitespaces 2014-12-20 15:55:54 +01:00
writing-rules.txt Document the 72 char limit on package description. 2015-07-13 12:16:45 +02:00