pts_interactive(1) [xfree86 man page]
PTS_INTERACTIVE(1) AFS Command Reference PTS_INTERACTIVE(1) NAME
pts_interactive - Enters interactive mode SYNOPSIS
pts interactive [-cell] <cell name> [-noauth] [-auth] [-localauth] [-force] pts in [-c] <cell name> [-n] [-f] DESCRIPTION
The pts interactive command allows the user to enter an interactive mode, useful for running bulk commands like creating new users or groups. pts interactive uses the authentication state supplied on its command line to run all bulk commands. However, if a bulk command is supplied with authentication options such as -cell, -localauth, -auth or -noauth then it, and all subsequent bulk commands, will be run with those options. CAUTIONS
Prior to OpenAFS 1.4.5 and OpenAFS 1.5.23, the pts interactive 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 pts 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 pts sleep command can be used in interactive mode or with pts source to give the Protection Server a change to catch up. OPTIONS
pts interactive only takes the standard pts options. -cell <cell name> Names the cell in which to run the command. For more details, see pts(1). -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. -help Prints the online help for this command. All other valid options are ignored. -localauth Constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. Do not combine this flag with the -cell or -noauth options. For more details, see pts(1). -noauth Assigns the unprivileged identity anonymous to the issuer. For more details, see pts(1). OUTPUT
The output is the same as if each individual command were run from the command line. EXAMPLES
Here is an example of a pts interactive 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 % 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 pts createuser require that the user belong to the system:administrators group, while others do not. SEE ALSO
pts(1), pts_quit(1), pts_sleep(1), pts_source(1), ptserver(8) COPYRIGHT
Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com> This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Jason Edgecombe for OpenAFS. OpenAFS 2014-04-08 PTS_INTERACTIVE(1)
Check Out this Related Man Page
PTS_INTERACTIVE(1) AFS Command Reference PTS_INTERACTIVE(1) NAME pts_interactive - Enters interactive mode SYNOPSIS pts interactive [-cell] <cell name> [-noauth] [-auth] [-localauth] [-force] pts in [-c] <cell name> [-n] [-f] DESCRIPTION The pts interactive command allows the user to enter an interactive mode, useful for running bulk commands like creating new users or groups. pts interactive uses the authentication state supplied on its command line to run all bulk commands. However, if a bulk command is supplied with authentication options such as -cell, -localauth, -auth or -noauth then it, and all subsequent bulk commands, will be run with those options. CAUTIONS Prior to OpenAFS 1.4.5 and OpenAFS 1.5.23, the pts interactive 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 pts 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 pts sleep command can be used in interactive mode or with pts source to give the Protection Server a change to catch up. OPTIONS pts interactive only takes the standard pts options. -cell <cell name> Names the cell in which to run the command. For more details, see pts(1). -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. -help Prints the online help for this command. All other valid options are ignored. -localauth Constructs a server ticket using a key from the local /etc/openafs/server/KeyFile file. Do not combine this flag with the -cell or -noauth options. For more details, see pts(1). -noauth Assigns the unprivileged identity anonymous to the issuer. For more details, see pts(1). OUTPUT The output is the same as if each individual command were run from the command line. EXAMPLES Here is an example of a pts interactive 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 % 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 pts createuser require that the user belong to the system:administrators group, while others do not. SEE ALSO pts(1), pts_quit(1), pts_sleep(1), pts_source(1), ptserver(8) COPYRIGHT Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com> This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Jason Edgecombe for OpenAFS. OpenAFS 2014-04-08 PTS_INTERACTIVE(1)