e2d32e23f2ce08966964e529c67fee11a598e715
[packages/trusty/cirros-testvm.git] / cirros-testvm / src-cirros / buildroot-2015.05 / docs / manual / customize-users-tables.txt
1 // -*- mode:doc; -*-
2 // vim: set syntax=asciidoc:
3
4 [[customize-users]]
5 === Adding custom user accounts
6
7 Sometimes it is needed to add specific users in the target system.
8 To cover this requirement, Buildroot provides support for so-called
9 _users tables_. To use this feature, set config option
10 +BR2_ROOTFS_USERS_TABLES+ to a space-separated list of users tables,
11 regular text files following the xref:makeuser-syntax[makeusers syntax].
12
13 As shown in xref:customize-dir-structure[], the recommended location for
14 such files is +board/<company>/<boardname>/+.
15
16 It should be noted that if the custom users are related to a specific
17 application, you should set variable +FOO_USERS+ in the package's +.mk+
18 file instead (see xref:generic-package-reference[]).