NetCube-Systems-Austria/kumquat-buildroot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

manual/user guide/customization: add section on users tables

Browse Source 
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>
This commit is contained in:
Thomas De Schampheleire 2014-09-18 21:39:30 +02:00 committed by Thomas Petazzoni
parent aba0d000cb
commit 5598d7f80a
3 changed files with 22 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/manual/customize-users-tables.txt Normal file
View File

@ -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[]).

3
docs/manual/customize.txt
View File

@ -20,6 +20,7 @@ Typical actions you may need to perform for a given project are:
+BR2_ROOTFS_DEVICE_TABLE+) +BR2_ROOTFS_DEVICE_TABLE+)
** adding custom devices nodes (using ** adding custom devices nodes (using
+BR2_ROOTFS_STATIC_DEVICE_TABLE+) +BR2_ROOTFS_STATIC_DEVICE_TABLE+)
* adding custom user accounts (using +BR2_ROOTFS_USERS_TABLES+)
* running arbitrary commands after generating the filesystem image * running arbitrary commands after generating the filesystem image
(using +BR2_ROOTFS_POST_IMAGE_SCRIPT+) (using +BR2_ROOTFS_POST_IMAGE_SCRIPT+)
* adding project-specific patches to some packages (using * adding project-specific patches to some packages (using
@ -48,6 +49,8 @@ include::customize-configuration.txt[]
include::customize-rootfs.txt[] include::customize-rootfs.txt[]
include::customize-users-tables.txt[]
include::customize-post-image.txt[] include::customize-post-image.txt[]
include::customize-packages.txt[] include::customize-packages.txt[]

2
docs/manual/makeusers-syntax.txt
View File

@ -1,7 +1,7 @@
// -*- mode:doc -*- ; // -*- mode:doc -*- ;
[[makeuser-syntax]] [[makeuser-syntax]]
== Makeuser syntax documentation == Makeusers syntax documentation
The syntax to create users is inspired by the makedev syntax, above, but The syntax to create users is inspired by the makedev syntax, above, but
is specific to Buildroot. is specific to Buildroot.