+=item B<-auth>
+
+Use the calling user's tokens to communicate with the Protection Server. For
+more details, see L<pts(1)>.
+
=item B<-cell> <I<cell name>>
Names the cell in which to run the command. For more details, see
L<pts(1)>.
+=item B<-config> <I<config directory>>
+
+Use an alternate config directory. For more details, see L<pts(1)>.
+
+=item B<-encrypt>
+
+Encrypts any communication with the Protection Server. For more details, see
+L<pts(1)>.
+
=item B<-force>
Enables the command to continue executing as far as possible when errors
specified foreign cell. Also, do not combine the B<-localauth> and
B<-noauth> flags.
+=item B<-auth>
+
+Use the calling user's tokens from the kernel to communicate with the ptserver
+(that is, the same tokens displayed by L<tokens(1)>. This is the default if
+neither B<-localauth> nor B<-noauth> is given.
+
+Since this option is the default, it is usually not useful for running single
+command line operations. However, it can be useful when running commands via
+L<pts_interactive(1)>, since otherwise it would be impossible to switch from,
+for example, B<-localauth> back to using regular tokens during a bulk
+operation. See L<pts_interactive(1)> for more details.
+
=back
=head1 PRIVILEGE REQUIRED
B<pts adduser> S<<< B<-user> <I<user name>>+ >>> S<<< B<-group> <I<group name>>+ >>>
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>]
+ [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts ad> S<<< B<-u> <I<user name>>+ >>> S<<< B<-g> <I<group name>>+ >>>
S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts chown> S<<< B<-name> <I<group name>> >>> S<<< B<-owner> <I<new owner>> >>>
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>]
+ [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts cho> S<<< B<-na> <I<group name>> >>> S<<< B<-o> <I<new owner>> >>>
S<<< [B<-c> <I<cell name>>] >>> [B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
S<<< [B<-owner> <I<owner of the group>>] >>>
S<<< [B<-id> <I<id (negated) for the group>>+] >>> S<<< [B<-cell> <I<cell name>>] >>>
[B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>]
+ [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts createg> S<<< B<-na> <I<group name>>+ >>> S<<< [B<-o> <I<owner of the group>>] >>>
S<<< [B<-i> <I<id (negated) for the group>>+] >>> S<<< [B<-c> <I<cell name>>] >>>
[B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
B<pts cg> S<<< B<-na> <I<group name>>+ >>> S<<< [B<-o> <I<owner of the group>>] >>>
S<<< [B<-i> <I<id (negated) for the group>>+] >>> S<<< [B<-c> <I<cell name>>] >>>
[B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts createuser> S<<< B<-name> <I<user name>>+ >>> S<<< [B<-id> <I<user id>>+] >>>
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-force>]
- [B<-help>]
+ [B<-help>] [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts createu> S<<< B<-na> <I<user name>>+ >>> S<<< [B<-i> <I<user id>>+] >>>
S<<< [B<-c> <I<cell name>>] >>> [B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
B<pts cu> S<<< B<-na> <I<user name>>+ >>> S<<< [B<-i> <I<user id>>+] >>>
S<<< [B<-c> <I<cell name>>] >>> [B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts delete> S<<< B<-nameorid> <I<user or group name or id>>+ >>>
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
- [B<-force>] [B<-help>]
+ [B<-force>] [B<-help>] [B<-auth>] [B<-encrypt>]
+ S<<< [B<-config> <I<config directory>>] >>>
B<pts d> S<<< B<-na> <I<user or group name or id>>+ >>>
S<<< [B<-c> <I<cell name>>] >>> [B<-no>] [B<-l>] [B<-f>] [-h]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts examine> S<<< B<-nameorid> <I<user or group name or id>>+ >>>
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
[B<-force>] [B<-auth>] [B<-help>]
+ [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts e> S<<< B<-na> <I<user or group name or id>>+ >>> S<<< [B<-c> <I<cell name>>] >>>
[B<-no>] [B<-l>] [B<-f>] [B<-a>] [B<-h>]
+ [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
B<pts check> S<<< B<-na> <I<user or group name or id>>+ >>> S<<< [B<-c> <I<cell name>>] >>>
[B<-no>] [B<-l>] [B<-f>] [B<-a>] [B<-h>]
+ [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
B<pts che> S<<< B<-na> <I<user or group name or id>>+ >>> S<<< [B<-c> <I<cell name>>] >>>
[B<-no>] [B<-l>] [B<-f>] [B<-a>] [B<-h>]
+ [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
well as names (IP addresses for machines) and IDs. Precede the GID of each
group with a hyphen to indicate that it is negative.
-=item B<-auth>
-
-Run using the user's current authentication. This is the default unless
-the B<-noauth> or B<-localauth> options are used.
-
=include fragments/pts-common.pod
=back
<div class="synopsis">
B<pts interactive> S<<< [B<-cell>] <I<cell name>> >>> [B<-noauth>]
- [B<-auth>] [B<-localauth>] [B<-force>]
+ [B<-auth>] [B<-localauth>] [B<-force>] [B<-help>]
+ [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
-B<pts in> S<<< [B<-c>] <I<cell name>> >>> [B<-n>] [B<-f>]
+
+B<pts in> S<<< [B<-c>] <I<cell name>> >>> [B<-n>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts listentries> [B<-users>] [B<-groups>] S<<< [B<-cell> <I<cell name>>] >>>
[B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>]
+ [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts liste> [B<-u>] [B<-g>] S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>]
- [B<-f>] [B<-h>]
+ [B<-f>] [B<-h>] [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
<div class="synopsis">
B<pts listmax> S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
- [B<-force>] [B<-help>]
+ [B<-force>] [B<-help>] [B<-auth>] [B<-encrypt>]
+ S<<< [B<-config> <I<config directory>>] >>>
B<pts listm> S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts listowned> S<<< B<-nameorid> <I<user or group name or id>>+ >>>
[-cell <I<cell name>>] [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>]
+ [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts listo> S<<< B<-na> <I<user or group name or id>>+ >>>
[-c <I<cell name>>] [B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts membership> S<<< B<-nameorid> <I<user or group name or id>>+ >>>
[B<-supergroups>] [B<-expandgroups>] S<<< [B<-cell> <I<cell name>>] >>>
[B<-localauth>] [B<-noauth>] [B<-force>] [B<-help>]
+ [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts m> S<<< B<-na> <I<user or group name or id>>+ >>>
[B<-s>] [B<-ex>] S<<< [B<-c> <I<cell name>>] >>>
[B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-en>] S<<< [B<-co> <I<config directory>>] >>>
B<pts groups> S<<< B<-na> <I<user or group name or id>>+ >>>
[B<-s>] [B<-ex>] S<<< [B<-c> <I<cell name>>] >>>
[B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-en>] S<<< [B<-co> <I<config directory>>] >>>
B<pts g> S<<< B<-na> <I<user or group name or id>>+ >>>
[B<-s>] [B<-ex>] S<<< [B<-c> <I<cell name>>] >>>
[B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-en>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
<div class="synopsis">
B<pts quit> S<<< [B<-cell>] <I<cell name>> >>> [B<-noauth>] [B<-localauth>]
- [B<-force>]
+ [B<-force>] [B<-help>] [B<-auth>] [B<-encrypt>]
+ S<<< [B<-config> <I<config directory>>] >>>
-B<pts q> S<<< [B<-c>] <I<cell name>> >>> [B<-n>] [B<-l>] [B<-f>]
+B<pts q> S<<< [B<-c>] <I<cell name>> >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts removeuser> S<<< B<-user> <I<user name>>+ >>> S<<< B<-group> <I<group name>>+ >>>
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-force>]
- [B<-help>]
+ [B<-help>] [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts rem> S<<< B<-u> <I<user name>>+ >>> S<<< B<-g> <I<group name>>+ >>>
S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
=over 4
-=item B<-name> <I<user name>>+
+=item B<-user> <I<user name>>+
Specifies the name of each user entry or the IP address (complete or
wildcard-style) of each machine entry to remove.
B<pts rename> S<<< B<-oldname> <I<old name>> >>> S<<< B<-newname> <I<new name>> >>>
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
- [B<-force>] [B<-help>]
+ [B<-force>] [B<-help>] [B<-auth>] [B<-encrypt>]
+ S<<< [B<-config> <I<config directory>>] >>>
B<pts ren> S<<< B<-o> <I<old name>> >>> S<<< B<-ne> <I<new name>> >>> S<<< [B<-c> <I<cell name>>] >>>
- [B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-no>] [B<-l>] [B<-f>] [B<-h>] [B<-a>] [B<-e>]
+ S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
S<<< [B<-access> <I<set privacy flags>>] >>>
S<<< [B<-groupquota> <I<set limit on group creation>>] >>>
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
- [B<-force>] [B<-help>]
+ [B<-force>] [B<-help>] [B<-auth>] [B<-encrypt>]
+ S<<< [B<-config> <I<config directory>>] >>>
B<pts setf> S<<< B<-na> <I<user or group name or id>>+ >>>
- S<<< [B<-a> <I<set privacy flags>>] >>>
+ S<<< [B<-ac> <I<set privacy flags>>] >>>
S<<< [B<-g> <I<set limit on group creation>>] >>> S<<< [B<-c> <I<cell name>>] >>>
- [B<-no>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-no>] [B<-l>] [B<-f>] [B<-h>] [B<-au>] [B<-e>]
+ S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts setmax> S<<< [B<-group> <I<group max>>] >>> S<<< [B<-user> <I<user max>>] >>>
S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>] [B<-force>] [B<-help>]
+ [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts setm> [B<-g> I<group max>>] S<<< [B<-u> <I<user max>>] >>>
S<<< [B<-c> <I<cell name>>] >>> [B<-n>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
B<pts sleep> S<<< [B<-delay>] <I<# of seconds>> >>>
S<<< [B<-cell>] <I<cell name>> >>> [B<-noauth>] [B<-localauth>] [B<-force>]
+ [B<-help>] [B<-auth>] [B<-encrypt>] S<<< [B<-config> <I<config directory>>] >>>
B<pts sl> S<<< [B<-d>] <I<# of seconds>> >>> S<<< [B<-c>] <I<cell name>> >>>
- [B<-n>] [B<-l>] [B<-f>]
+ [B<-n>] [B<-l>] [B<-f>] [B<-h>]
+ [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
=over 4
+=item B<-delay> <I<# of seconds>>
+
+Specifies the amount of time to sleep, in seconds.
+
=include fragments/pts-common.pod
=back
<div class="synopsis">
B<pts source> S<<< [B<-file>] <I<file name>> >>> S<<< [B<-cell>] <I<cell name>> >>>
- [B<-noauth>] [B<-localauth>] [B<-force>]
+ [B<-noauth>] [B<-localauth>] [B<-force>] [B<-auth>] [B<-encrypt>] [B<-help>]
+ S<<< [B<-config> <I<config directory>>] >>>
B<pts so> S<<< [B<-f>] <I<file name>> >>> S<<< [B<-c>] <I<cell name>> >>>
- [B<-n>] [B<-l>] [B<-f>]
+ [B<-n>] [B<-l>] [B<-f>] [B<-h>] [B<-a>] [B<-e>] S<<< [B<-co> <I<config directory>>] >>>
=for html
</div>
=over 4
+=item B<-file> <I<file name>>
+
+Specifies the file name to read commands from. The commands in the given file
+are run as if they were typed in pts interactive mode.
+
=include fragments/pts-common.pod
=back