From a25431ec8b7da248f0b8a2ee13b6dbe253b17f6a Mon Sep 17 00:00:00 2001 From: Jason Edgecombe Date: Sat, 18 Aug 2007 03:50:20 +0000 Subject: [PATCH] DEVEL15-man-page-pts-pullup-20070817 For some reason, the previous pullup didn't cvs add these files. Really pull them up from the trunk. --- doc/man-pages/pod1/pts_interactive.pod | 119 +++++++++++++++++++++++++ doc/man-pages/pod1/pts_sleep.pod | 81 +++++++++++++++++ doc/man-pages/pod1/pts_source.pod | 90 +++++++++++++++++++ 3 files changed, 290 insertions(+) create mode 100644 doc/man-pages/pod1/pts_interactive.pod create mode 100644 doc/man-pages/pod1/pts_sleep.pod create mode 100644 doc/man-pages/pod1/pts_source.pod diff --git a/doc/man-pages/pod1/pts_interactive.pod b/doc/man-pages/pod1/pts_interactive.pod new file mode 100644 index 000000000..9d6257246 --- /dev/null +++ b/doc/man-pages/pod1/pts_interactive.pod @@ -0,0 +1,119 @@ +=head1 NAME + +pts interactive - Enters interactive mode + +=head1 SYNOPSIS + +=for html +
+ +B S<<< [B<-cell>] > >>> [B<-noauth>] + [B<-force>] + +B S<<< [B<-c>] > >>> [B<-n>] [B<-f>] + +=for html +
+ +=head1 DESCRIPTION + +The B command allows the user to enter an interactive +mode, useful for running bulk commands like creating new users or groups. + +=head1 CAUTIONS + +Prior to OpenAFS 1.4.5 and OpenAFS 1.5.23, the B command +was only available on Unix or Linux and when OpenAFS was compiled with the +supergroups option (disabled by default). As of OpenAFS 1.4.5 and 1.5.23, +it is always available. + +Running bulk B commands may degrade the performance of the Protection +Server while they are run and server resources may not be released +immediately after commands are run. The B command can be used +in interactive mode or with B to give the Protection Server a +change to catch up. + +=head1 OPTIONS + +B only takes the standard B options. + +=over 4 + +=item B<-cell> > + +Names the cell in which to run the command. For more details, see +L. + +=item B<-force> + +Enables the command to continue executing as far as possible when errors +or other problems occur, rather than halting execution at the first error. +This is useful for bulk operations where you would like to continue even +if one of many operations fails. + +=item B<-noauth> + +Assigns the unprivileged identity anonymous to the issuer. For more +details, see L. + +=back + +=head1 OUTPUT + +The output is the same as if each individual command were run from the +command line. + +=head1 EXAMPLES + +Here is an example of a B session: + + % pts interactive + pts> examine admin + Name: admin, id: 1, owner: system:administrators, creator: anonymous, + membership: 2, flags: S----, group quota: 20. + pts> help + pts: Commands are: + adduser add a user to a group + apropos search by help text + chown change ownership of a group + creategroup create a new group + createuser create a new user + delete delete a user or group from database + examine examine an entry + help get help on commands + interactive enter interactive mode + listentries list users/groups in the protection database + listmax list max id + listowned list groups owned by an entry or zero id gets orphaned groups + membership list membership of a user or group + quit exit program + removeuser remove a user from a group + rename rename user or group + setfields set fields for an entry + setmax set max id + sleep pause for a bit + source read commands from file + pts> quit + % + +=head1 PRIVILEGE REQUIRED + +The same privilege is required to run the command in interactive mode as +is required to run the command by itself on the command line. Some +commands such as B require that the user belong to the +system:administrators group, while others do not. + +=head1 SEE ALSO + +L, +L, +L, +L, +L + +=head1 COPYRIGHT + +Copyright 2007 Jason Edgecombe + +This documentation is covered by the IBM Public License Version 1.0. This +man page was written by Jason Edgecombe for OpenAFS. diff --git a/doc/man-pages/pod1/pts_sleep.pod b/doc/man-pages/pod1/pts_sleep.pod new file mode 100644 index 000000000..23db3b547 --- /dev/null +++ b/doc/man-pages/pod1/pts_sleep.pod @@ -0,0 +1,81 @@ +=head1 NAME + +pts sleep - Pauses for a few seconds + +=head1 SYNOPSIS + +=for html +
+ +B S<<< [B<-delay>] > >>> + S<<< [B<-cell>] > >>> [B<-noauth>] [B<-force>] + +B S<<< [B<-d>] > >>> S<<< [B<-c>] > >>> + [B<-n>] [B<-f>] + +=for html +
+ +=head1 DESCRIPTION + +The B pauses for a specified number of seconds. The command can +be run from the command line or interactively, although from the command +line it's essentially equivalent to the B command. It is intended +for use in interactive mode to pause for a few seconds between batch +commands to allow the Protection Server to catch up. + +=head1 CAUTIONS + +Prior to OpenAFS 1.4.5 and OpenAFS 1.5.23, the B command was +only available on Unix or Linux and when OpenAFS was compiled with the +supergroups option (disabled by default). As of OpenAFS 1.4.5 and 1.5.23, +it is always available. + +=head1 OPTIONS + +Although they have no effect, B takes the following standard +B options: + +=over 4 + +=item B<-cell> > + +Names the cell in which to run the command. For more details, see +L. + +=item B<-force> + +Enables the command to continue executing as far as possible when errors +or other problems occur, rather than halting execution at the first error. + +=item B<-noauth> + +Assigns the unprivileged identity anonymous to the issuer. For more +details, see L. + +=back + +=head1 OUTPUT + +This command produces no output. + +=head1 EXAMPLES + +Here is an example of a B session: + + % pts interactive + pts> sleep 5 + pts> quit + % + +=head1 SEE ALSO + +L, +L + +=head1 COPYRIGHT + +Copyright 2007 Jason Edgecombe + +This documentation is covered by the IBM Public License Version 1.0. This +man page was written by Jason Edgecombe for OpenAFS. diff --git a/doc/man-pages/pod1/pts_source.pod b/doc/man-pages/pod1/pts_source.pod new file mode 100644 index 000000000..0992690ad --- /dev/null +++ b/doc/man-pages/pod1/pts_source.pod @@ -0,0 +1,90 @@ +=head1 NAME + +pts source - Read pts commands from a file + +=head1 SYNOPSIS + +=for html +
+ +B S<<< [B<-file>] > >>> S<<< [B<-cell>] > >>> + [B<-noauth>] [B<-force>] + +B S<<< [B<-f>] > >>> S<<< [B<-c>] > >>> + [B<-n>] [B<-f>] + +=for html +
+ +=head1 DESCRIPTION + +The B runs commands from a file as if they were typed in B mode. The command can be run from the command line or +interactively. + +=head1 CAUTIONS + +Prior to OpenAFS 1.4.5 and OpenAFS 1.5.23, the B command was +only available on Unix or Linux and when OpenAFS was compiled with the +supergroups option (disabled by default). As of OpenAFS 1.4.5 and 1.5.23, +it is always available. + +=head1 OPTIONS + +B takes the following options: + +=over 4 + +=item B<-cell> > + +Names the cell in which to run the command. For more details, see +L. + +=item B<-file> > + +Specifies the filename from which to read commands. + +=item B<-force> + +Enables the command to continue executing as far as possible when errors +or other problems occur, rather than halting execution at the first error. +This is useful for bulk operations where you would like to continue even +if one of many operations fails. + +=item B<-noauth> + +Assigns the unprivileged identity anonymous to the issuer. For more +details, see L. + +=back + +=head1 OUTPUT + +This command shows the output of each comand in the file as if it were +run normally. + +=head1 EXAMPLES + +Here is an example of using B in a B session: + + % echo examine admin > /tmp/commands.txt + % pts interactive + pts> source /tmp/commands.txt + Name: admin, id: 1, owner: system:administrators, creator: anonymous, + membership: 2, flags: S----, group quota: 20. + pts> quit + % + +=head1 SEE ALSO + +L, +L, +L, +L + +=head1 COPYRIGHT + +Copyright 2007 Jason Edgecombe + +This documentation is covered by the IBM Public License Version 1.0. This +man page was written by Jason Edgecombe for OpenAFS. -- 2.39.5