3 pts_interactive - Enters interactive mode
10 B<pts interactive> S<<< [B<-cell>] <I<cell name>> >>> [B<-noauth>]
11 [B<-auth>] [B<-localauth>] [B<-force>] [B<-help>]
12 [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
15 B<pts in> S<<< [B<-c>] <I<cell name>> >>> [B<-n>] [B<-f>] [B<-h>]
16 [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
23 The B<pts interactive> command allows the user to enter an interactive
24 mode, useful for running bulk commands like creating new users or groups.
26 B<pts interactive> uses the authentication state supplied on its command
27 line to run all bulk commands. However, if a bulk command is supplied
28 with authentication options such as B<-cell>, B<-localauth>, B<-auth>
29 or B<-noauth> then it, and all subsequent bulk commands, will be run with
34 Prior to OpenAFS 1.4.5 and OpenAFS 1.5.23, the B<pts interactive> command
35 was only available on Unix or Linux and when OpenAFS was compiled with the
36 supergroups option (disabled by default). As of OpenAFS 1.4.5 and 1.5.23,
37 it is always available.
39 Running bulk B<pts> commands may degrade the performance of the Protection
40 Server while they are run and server resources may not be released
41 immediately after commands are run. The B<pts sleep> command can be used
42 in interactive mode or with B<pts source> to give the Protection Server a
47 B<pts interactive> only takes the standard B<pts> options.
51 =include fragments/pts-common.pod
57 The output is the same as if each individual command were run from the
62 Here is an example of a B<pts interactive> session:
66 Name: admin, id: 1, owner: system:administrators, creator: anonymous,
67 membership: 2, flags: S----, group quota: 20.
70 adduser add a user to a group
71 apropos search by help text
72 chown change ownership of a group
73 creategroup create a new group
74 createuser create a new user
75 delete delete a user or group from database
76 examine examine an entry
77 help get help on commands
78 interactive enter interactive mode
79 listentries list users/groups in the protection database
81 listowned list groups owned by an entry or zero id gets orphaned groups
82 membership list membership of a user or group
84 removeuser remove a user from a group
85 rename rename user or group
86 setfields set fields for an entry
89 source read commands from file
93 =head1 PRIVILEGE REQUIRED
95 The same privilege is required to run the command in interactive mode as
96 is required to run the command by itself on the command line. Some
97 commands such as B<pts createuser> require that the user belong to the
98 system:administrators group, while others do not.
110 Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>
112 This documentation is covered by the BSD License as written in the
113 doc/LICENSE file. This man page was written by Jason Edgecombe for