1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
|
.Dd March 25, 2000
.Dt PTS 1
.Os
.Sh NAME
.Nm pts
.Nd Manage AFS protection database
.Sh SYNOPSIS
.Nm pts
.Op Ar command
.Op Ar args
.Sh DESCRIPTION
The
.Nm
utility is used to manipulate the contents of the AFS Protection Database,
which contains information about users and groups and is handled by the
Protection Server.
Note that the
.Nm
utility does
.Em not
modify the traditional
.Ux
user and group database, only the AFS specific information.
.Pp
The
.Nm
utility provides several commands:
.Pp
.Bl -tag -width Fl -compact
.It Cm adduser
add a user to a group
.It Cm chown
change owner of user or group
.It Cm creategroup / cg
create a new group
.It Cm createuser
create a new user
.It Cm dump
dump pts database
.It Cm delete
delete user or group
.It Cm examine
examine a user or a group
.It Cm help Cm ?
get help on
.Nm
.It Cm listmax
print largest uid and gid
.It Cm listowned
list groups owned by a user or group, or orphaned groups
.It Cm membership Cm groups
list group or user membership
.It Cm removeuser
remove a user from a group
.It Cm rename
rename user/group
.It Cm setfields
not yet implemented
.It Cm setmax
not yet implemented
.It Cm syncdb
not yet implemented
.El
.Pp
Most
.Nm
commands accept the following general arguments:
.Pp
.Bd -filled -offset indent -compact
.Op Fl cell Ar cellname
Specifies which AFS cell to use, if the default cell is not to be used.
.Pp
.Op Fl noauth
Specifies that
.Nm
should not try to authenticate the connection to the server. This may be
useful with shell scripts, or if there is a problem with the AFS cell.
Note that the server will reject many commands if
.Fl noauth
is specified.
.Ed
.Pp
The syntax of the
.Nm
commands:
.Pp
.Nm pts adduser
.Op Fl name
.Ar user
.Op Fl group
.Ar group
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
Add the specified user to the specified group.
.Ed
.Pp
.Nm pts chown
.Op Fl name
.Ar user/group
.Op Fl owner
.Ar owner
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
Change owner of a group or user.
.Ed
.Pp
.Nm pts creategroup
.Op Fl name
.Ar name
.Op Fl id Ar idnumber
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
Create a new group. If
.Fl id
is not specified, a new idnumber is taken automatically.
.Ed
.Pp
.Nm pts cg
.Bd -filled -offset indent -compact
.Nm pts cg
is an alias for the
.Nm pts creategroup
command.
.Ed
.Pp
.Nm pts createuser
.Op Fl name
.Ar name
.Op Fl id Ar idnumber
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
Create a new user. If
.Fl id
is not specified, a new idnumber is taken automatically.
.Ed
.Pp
.Nm pts dump
.Ar server
.Op Fl cell cellname
.Bd -filled -offset indent -compact
Dump the Protection Database in a human readable form. The database is read
from the given database server.
.Ed
.Pp
.Nm pts delete
.Op Fl name
.Ar name/group
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
Delete a user or group from the database.
.Ed
.Pp
.Nm pts examine
.Ar user/group
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
Print verbose information about a user or a group.
.Ed
.Pp
.Nm pts help
or
.Nm pts ?
.Bd -filled -offset indent -compact
Print help about
.Nm
.Ed
.Pp
.Nm pts listmax
.Op Fl cell Ar cellname
.Bd -filled -offset indent -compact
Print the largest uid and gid.
.Ed
.Pp
.Nm pts listowned
.Op Fl id
.Ar user/group
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
List the groups owned by a user or group.
.Ed
.Pp
.Nm pts membership
.Op Fl nameorid Ar user/group
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
List the members of a group, or the groups a user is a member of.
.Ed
.Pp
.Nm pts groups
.Bd -filled -offset indent -compact
.Nm pts groups
is an alias for the
.Nm pts membership
command.
.Ed
.Pp
.Nm pts removeuser
.Op Fl user
.Ar user
.Op Fl group
.Ar group
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
Remove a users membership from a group.
.Ed
.Pp
.Nm pts rename
.Op Fl from
.Ar "old name"
.Op Fl to
.Ar "new name"
.Op Fl cell Ar cellname
.Op Fl noauth
.Bd -filled -offset indent -compact
Rename a user or group.
.Ed
.Pp
.Nm pts setfields
.Bd -filled -offset indent -compact
This command is available in the original AFS client, but has not been
implemented yet.
.Ed
.Pp
.Nm pts setmax
.Bd -filled -offset indent -compact
This command is available in the original AFS client, but has not been
implemented yet.
.Ed
.Pp
.Nm pts syncdb
.Bd -filled -offset indent -compact
This command has not been implemented yet.
.Ed
.Pp
.Sh SEE ALSO
.Xr afsd 8 ,
.Xr fs 1 ,
.Xr vos 8
.Sh STANDARDS
The Arla authors are trying to mimic the behaviour of the original AFS
utilities.
.Sh AUTHORS
The Arla project <http://www.stacken.kth.se/project/arla/>.
.Sh BUGS
Some commands are not implemented yet.
|
