Initial commit for Tizen
[profile/extras/shadow-utils.git] / man / sv / groupadd.8
1 '\" t
2 .\"     Title: groupadd
3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
5 .\"      Date: 16-02-2011
6 .\"    Manual: Systemhanteringskommandon
7 .\"    Source: Systemhanteringskommandon
8 .\"  Language: Swedish
9 .\"
10 .TH "GROUPADD" "8" "16-02-2011" "Systemhanteringskommandon" "Systemhanteringskommandon"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el       .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NAMN"
31 groupadd \- skapa en ny grupp
32 .SH "SYNOPSIS"
33 .HP \w'\fBgroupadd\fR\ 'u
34 \fBgroupadd\fR [\fIflaggor\fR] \fIgrupp\fR
35 .SH "BESKRIVNING"
36 .PP
37 The
38 \fBgroupadd\fR
39 command creates a new group account using the values specified on the command line plus the default values from the system\&. The new group will be entered into the system files as needed\&.
40 .SH "FLAGGOR"
41 .PP
42 Flaggorna som g\(:aller f\(:or kommandot
43 \fBgroupadd\fR
44 \(:ar:
45 .PP
46 \fB\-f\fR, \fB\-\-force\fR
47 .RS 4
48 This option causes the command to simply exit with success status if the specified group already exists\&. When used with
49 \fB\-g\fR, and the specified GID already exists, another (unique) GID is chosen (i\&.e\&.
50 \fB\-g\fR
51 is turned off)\&.
52 .RE
53 .PP
54 \fB\-g\fR, \fB\-\-gid\fR\fIGID\fR
55 .RS 4
56 The numerical value of the group\*(Aqs ID\&. This value must be unique, unless the
57 \fB\-o\fR
58 option is used\&. The value must be non\-negative\&. The default is to use the smallest ID value greater than 999 and greater than every other group\&. Values between 0 and 999 are typically reserved for system accounts\&.
59 .RE
60 .PP
61 \fB\-h\fR, \fB\-\-help\fR
62 .RS 4
63 Visa hj\(:alpmeddelande och avsluta\&.
64 .RE
65 .PP
66 \fB\-K\fR, \fB\-\-key\fR\fINYCKEL\fR=\fIV\(:ARDE\fR
67 .RS 4
68 \(oAsidos\(:atter standardv\(:arden i
69 /etc/login\&.defs
70 (GID_MIN, GID_MAX och andra)\&. Flera flaggor av
71 \fB\-K\fR
72 kan anges\&.
73 .sp
74 Example:
75 \fB\-K \fR\fIGID_MIN\fR=\fI100\fR
76 \fB\-K \fR\fIGID_MAX\fR=\fI499\fR
77 .sp
78 Notera:
79 \fB\-K \fR\fIGID_MIN\fR=\fI10\fR,\fIGID_MAX\fR=\fI499\fR
80 fungerar \(:annu inte\&.
81 .RE
82 .PP
83 \fB\-o\fR, \fB\-\-non\-unique\fR
84 .RS 4
85 This option permits to add a group with a non\-unique GID\&.
86 .RE
87 .PP
88 \fB\-p\fR, \fB\-\-password\fR\fIL\(:OSENORD\fR
89 .RS 4
90 The encrypted password, as returned by
91 \fBcrypt\fR(3)\&. The default is to disable the password\&.
92 .sp
93
94 \fBNote:\fR
95 This option is not recommended because the password (or encrypted password) will be visible by users listing the processes\&.
96 .sp
97 You should make sure the password respects the system\*(Aqs password policy\&.
98 .RE
99 .PP
100 \fB\-r\fR, \fB\-\-system\fR
101 .RS 4
102 Create a system group\&.
103 .sp
104 The numeric identifiers of new system groups are choosen in the
105 \fBSYS_GID_MIN\fR\-\fBSYS_GID_MAX\fR
106 range, defined in
107 login\&.defs, instead of
108 \fBGID_MIN\fR\-\fBGID_MAX\fR\&.
109 .RE
110 .SH "CONFIGURATION"
111 .PP
112 The following configuration variables in
113 /etc/login\&.defs
114 change the behavior of this tool:
115 .PP
116 \fBGID_MAX\fR (number), \fBGID_MIN\fR (number)
117 .RS 4
118 Range of group IDs used for the creation of regular groups by
119 \fBuseradd\fR,
120 \fBgroupadd\fR, or
121 \fBnewusers\fR\&.
122 .RE
123 .PP
124 \fBMAX_MEMBERS_PER_GROUP\fR (number)
125 .RS 4
126 Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
127 /etc/group
128 (with the same name, same password, and same GID)\&.
129 .sp
130 The default value is 0, meaning that there are no limits in the number of members in a group\&.
131 .sp
132 This feature (split group) permits to limit the length of lines in the group file\&. This is useful to make sure that lines for NIS groups are not larger than 1024 characters\&.
133 .sp
134 If you need to enforce such limit, you can use 25\&.
135 .sp
136 Note: split groups may not be supported by all tools (even in the Shadow toolsuite)\&. You should not use this variable unless you really need it\&.
137 .RE
138 .PP
139 \fBSYS_GID_MAX\fR (number), \fBSYS_GID_MIN\fR (number)
140 .RS 4
141 Range of group IDs used for the creation of system groups by
142 \fBuseradd\fR,
143 \fBgroupadd\fR, or
144 \fBnewusers\fR\&.
145 .RE
146 .SH "FILER"
147 .PP
148 /etc/group
149 .RS 4
150 Gruppkontoinformation\&.
151 .RE
152 .PP
153 /etc/gshadow
154 .RS 4
155 S\(:aker gruppkontoinformation\&.
156 .RE
157 .PP
158 /etc/login\&.defs
159 .RS 4
160 Shadow password suite configuration\&.
161 .RE
162 .SH "T\(:ANK P\(oA"
163 .PP
164 Groupnames must start with a lower case letter or an underscore, followed by lower case letters, digits, underscores, or dashes\&. They can end with a dollar sign\&. In regular expression terms: [a\-z_][a\-z0\-9_\-]*[$]?
165 .PP
166 Groupnames may only be up to characters long\&.
167 .PP
168 You may not add a NIS or LDAP group\&. This must be performed on the corresponding server\&.
169 .PP
170 If the groupname already exists in an external group database such as NIS or LDAP,
171 \fBgroupadd\fR
172 will deny the group creation request\&.
173 .SH "AVSLUTNINGSV\(:ARDEN"
174 .PP
175 Kommandot
176 \fBgroupadd\fR
177 avslutas med f\(:oljande v\(:arden:
178 .PP
179 \fI0\fR
180 .RS 4
181 lyckad
182 .RE
183 .PP
184 \fI2\fR
185 .RS 4
186 ogiltig kommandosyntax
187 .RE
188 .PP
189 \fI3\fR
190 .RS 4
191 ogiltigt argument till flagga
192 .RE
193 .PP
194 \fI4\fR
195 .RS 4
196 GID inte unikt (n\(:ar
197 \fB\-o\fR
198 inte anv\(:ands)
199 .RE
200 .PP
201 \fI9\fR
202 .RS 4
203 gruppnamn inte unikt
204 .RE
205 .PP
206 \fI10\fR
207 .RS 4
208 kan inte uppdatera gruppfilen
209 .RE
210 .SH "SE OCKS\(oA"
211 .PP
212 \fBchfn\fR(1),
213 \fBchsh\fR(1),
214 \fBpasswd\fR(1),
215 \fBgpasswd\fR(8),
216 \fBgroupdel\fR(8),
217 \fBgroupmod\fR(8),
218 \fBlogin.defs\fR(5),
219 \fBuseradd\fR(8),
220 \fBuserdel\fR(8),
221 \fBusermod\fR(8)\&.