]> git.proxmox.com Git - systemd.git/blame - man/systemd-sysusers.8
Imported Upstream version 217
[systemd.git] / man / systemd-sysusers.8
CommitLineData
e842803a 1'\" t
5eef597e 2.TH "SYSTEMD\-SYSUSERS" "8" "" "systemd 217" "systemd-sysusers"
e842803a
MB
3.\" -----------------------------------------------------------------
4.\" * Define some portability stuff
5.\" -----------------------------------------------------------------
6.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7.\" http://bugs.debian.org/507673
8.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10.ie \n(.g .ds Aq \(aq
11.el .ds Aq '
12.\" -----------------------------------------------------------------
13.\" * set default formatting
14.\" -----------------------------------------------------------------
15.\" disable hyphenation
16.nh
17.\" disable justification (adjust text to left margin only)
18.ad l
19.\" -----------------------------------------------------------------
20.\" * MAIN CONTENT STARTS HERE *
21.\" -----------------------------------------------------------------
22.SH "NAME"
23systemd-sysusers, systemd-sysusers.service \- Allocate system users and groups
24.SH "SYNOPSIS"
25.HP \w'\fBsystemd\-sysusers\fR\ 'u
26\fBsystemd\-sysusers\fR [OPTIONS...] [\fICONFIGFILE\fR...]
27.PP
28systemd\-sysusers\&.service
29.SH "DESCRIPTION"
30.PP
31\fBsystemd\-sysusers\fR
32creates system users and groups, based on the file format and location specified in
33\fBsysusers.d\fR(5)\&.
34.PP
35If invoked with no arguments, it applies all directives from all files found\&. If one or more filenames are passed on the command line, only the directives in these files are applied\&. If only the basename of a file is specified, all directories as specified in
36\fBsysusers.d\fR(5)
5eef597e
MP
37are searched for a matching file\&. If the string
38\-
39is specified as filenames entries from the standard input of the process are read\&.
e842803a
MB
40.SH "OPTIONS"
41.PP
42The following options are understood:
43.PP
44\fB\-\-root=\fR\fB\fIroot\fR\fR
45.RS 4
46Takes a directory path as an argument\&. All paths will be prefixed with the given alternate
47\fIroot\fR
48path, including config search paths\&.
49.RE
50.PP
51\fB\-h\fR, \fB\-\-help\fR
52.RS 4
53Print a short help text and exit\&.
54.RE
55.PP
56\fB\-\-version\fR
57.RS 4
58Print a short version string and exit\&.
59.RE
60.SH "EXIT STATUS"
61.PP
62On success, 0 is returned, a non\-zero failure code otherwise\&.
63.SH "SEE ALSO"
64.PP
65\fBsystemd\fR(1),
66\fBsysusers.d\fR(5)