Commit 5598d7f8 authored by Thomas De Schampheleire's avatar Thomas De Schampheleire Committed by Thomas Petazzoni
Browse files

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: default avatarThomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: default avatarThomas Petazzoni <thomas.petazzoni@free-electrons.com>
parent aba0d000

docs/manual/customize-users-tables.txt

0 → 100644
+18 −0
Original line number Diff line number Diff line 
// -*- 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[]).

docs/manual/customize.txt

+3 −0
Original line number Diff line number Diff line
@@ -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[]

docs/manual/makeusers-syntax.txt

+1 −1
Original line number Diff line number Diff line 
// -*- 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.