diff options
| author | Thomas De Schampheleire <patrickdepinguin@gmail.com> | 2014-09-18 21:39:30 +0200 |
|---|---|---|
| committer | Thomas Petazzoni <thomas.petazzoni@free-electrons.com> | 2014-09-21 19:41:12 +0200 |
| commit | 5598d7f80aee23fe79875a1a048f06c3ec614c26 (patch) | |
| tree | a4c3c5a25f363dc4563eb226df6822b8dfb3c768 | |
| parent | aba0d000cb57edf54e5a8b16702ae803433512f1 (diff) | |
| download | buildroot-5598d7f80aee23fe79875a1a048f06c3ec614c26.tar.gz buildroot-5598d7f80aee23fe79875a1a048f06c3ec614c26.zip | |
manual/user guide/customization: add section on users tables
This patch adds basic documentation on users tables, a topic which was
currently not yet covered in the manual.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
| -rw-r--r-- | docs/manual/customize-users-tables.txt | 18 | ||||
| -rw-r--r-- | docs/manual/customize.txt | 3 | ||||
| -rw-r--r-- | docs/manual/makeusers-syntax.txt | 2 |
3 files changed, 22 insertions, 1 deletions
diff --git a/docs/manual/customize-users-tables.txt b/docs/manual/customize-users-tables.txt new file mode 100644 index 0000000000..e2d32e23f2 --- /dev/null +++ b/docs/manual/customize-users-tables.txt @@ -0,0 +1,18 @@ +// -*- mode:doc; -*- +// vim: set syntax=asciidoc: + +[[customize-users]] +=== Adding custom user accounts + +Sometimes it is needed to add specific users in the target system. +To cover this requirement, Buildroot provides support for so-called +_users tables_. To use this feature, set config option ++BR2_ROOTFS_USERS_TABLES+ to a space-separated list of users tables, +regular text files following the xref:makeuser-syntax[makeusers syntax]. + +As shown in xref:customize-dir-structure[], the recommended location for +such files is +board/<company>/<boardname>/+. + +It should be noted that if the custom users are related to a specific +application, you should set variable +FOO_USERS+ in the package's +.mk+ +file instead (see xref:generic-package-reference[]). diff --git a/docs/manual/customize.txt b/docs/manual/customize.txt index ad335b9ab5..0a73988cb3 100644 --- a/docs/manual/customize.txt +++ b/docs/manual/customize.txt @@ -20,6 +20,7 @@ Typical actions you may need to perform for a given project are: +BR2_ROOTFS_DEVICE_TABLE+) ** adding custom devices nodes (using +BR2_ROOTFS_STATIC_DEVICE_TABLE+) +* adding custom user accounts (using +BR2_ROOTFS_USERS_TABLES+) * running arbitrary commands after generating the filesystem image (using +BR2_ROOTFS_POST_IMAGE_SCRIPT+) * adding project-specific patches to some packages (using @@ -48,6 +49,8 @@ include::customize-configuration.txt[] include::customize-rootfs.txt[] +include::customize-users-tables.txt[] + include::customize-post-image.txt[] include::customize-packages.txt[] diff --git a/docs/manual/makeusers-syntax.txt b/docs/manual/makeusers-syntax.txt index 9c616043b3..5b3f34777e 100644 --- a/docs/manual/makeusers-syntax.txt +++ b/docs/manual/makeusers-syntax.txt @@ -1,7 +1,7 @@ // -*- mode:doc -*- ; [[makeuser-syntax]] -== Makeuser syntax documentation +== Makeusers syntax documentation The syntax to create users is inspired by the makedev syntax, above, but is specific to Buildroot. |
