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)