pts_interactive - Enters interactive mode
pts interactive [-cell] <cell name> [-noauth] [-auth] [-localauth] [-force] [-principal <principal>] [-keytab <keytab_file>] [-encrypt [<yes|no>]] [-srcport <set UDP port number>] [-config <configuration file>] [-help]
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, -noauth, -auth or -encrypt then that command will be run with those options.
pts interactive only takes the common pts(1) options.
Use the calling user's tokens to communicate with the Protection Server. For more details, see pts(1).
Names the cell in which to run the command. For more details, see pts(1).
Sets the location of the configuration file to be used. The default file is /etc/yfs/yfs-client.conf. For more details, see pts(1).
Enables or disables encryption for any communication with the Protection Server. For more details, see pts(1).
Enables the command to continue executing as far as possible when errors or other problems occur, rather than halting execution at the first error.
Prints the online help for this command. All other valid options are ignored.
Constructs a server ticket using a key from the local /etc/yfs/server/KeyFileExt file. Do not combine this flag with the -cell or -noauth options. For more details, see pts(1).
Assigns the unprivileged identity anonymous to the issuer. For more details, see pts(1).
Specifies the principal to be used for authentication. This can help in selecting the correct credentials cache when several are available in a cache collection.
Specifies a Kerberos v5 keytab file containing a key for the client principal specified by -principal.
Set the source Rx UDP port to the numeric value specified. If the designated port is in use then a random port number will be assigned by the operating system.
The output is the same as if each individual command were run from the command line.
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
%
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(1) require that the user belong to the <system:administrators> group, while others do not.
pts(1), pts_quit(1), pts_sleep(1), pts_source(1), ptserver(8)
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 originally written by Jason Edgecombe for OpenAFS.
"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)
"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)
The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).
"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).
"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.