2.0;edppo (edit_ppo_file), revision 2.0, 83/02/03
EDPPO (EDIT_PPO_FILE) -- Edit/list person, project, or organization names.
usage: EDPPO { [-R rgypath] [-LOC] [-PERS] [-PROJ] [-ORG] [-A name [fullname]]
[-D name] [-L [name..]] [-LF [name..]]
[-NP] [-COL] }
FORMAT
EDPPO {options}
EDPPO is used to define usernames in the network registry. This is a prelude
to creating network accounts, which associate usernames with login home
directories and passwords. See the help file for EDACCT (EDIT_ACCOUNT) to
perform that operation.
While all of the available EDPPO options are described below, you will
probably not be able to edit network registry files unless you are the network
administrator for your network. You should, however, be able to list the
contents of the network and local registries. Use EDPPO to find out who is
associated with a particular username and account.
For detailed examples of editing network registry files and complete
information on network registry commands, see Administering Your DOMAIN
System.
OPTIONS
If you omit the -A, -D, -L, and -LF options, EDPPO enters an interactive
editing session which reads commands from standard input as described in the
COMMANDS section below.
Default options are indicated by "(D)."
-R pathname Specify the registry to be edited or listed. You should
only use this option with -LOC (described below) to edit or
list a remote node's local registry. If you want to edit
or list the master registry, omit this option and let EDPPO
use the network registry file copy ('/registry/registry')
on the current node to locate the master registry.
-LOC Specify that the node's local registry
('/registry/local_registry') is to be edited or listed. If
you specify -LOC, the only other valid options are -R -L,
-LF, -COL, and -D. You may not manipulate the local
registry using EDPPO's interactive mode; the list or delete
functions must be specified on the command line.
-PERS (D) Edit or list the contents of the Person file.
-PROJ Edit or list the contents of the Project file.
-ORG Edit or list the contents of the Organization file.
-A name [fullname]
Add a name and optional full name text. PPO names can be
up to 32 characters long, must begin with a letter and can
include only letters, numbers, and underscores (_). PPO
names are automatically maintained in lowercase.
Associated full name text is optional but strongly
recommended. It can include any characters and be up to 32
characters long. Use single (or double) quotation marks to
embed spaces (or quotation marks) in a full name.
-D name Delete a name. Command line delete is valid only on a local
registry. To delete a name from the network registry file,
use EDPPO's interactive mode. DELETE WITH EXTREME CAUTION,
even locally, because once you delete a name no one can
EVER access any files created by the user who had that PPO.
(The system cannot recreate a unique name identifier once
it has been deleted.) Normally, you should delete people's
accounts (using EDACCT), NOT their names.
-L [name...] List the name(s) specified. If 'name' is omitted, all
names are listed.
-LF [name ...]
List the name(s) specified, along with associated full name
text, if any. If 'name' is omitted, all names are listed.
-COL List the names in a single column.
-NP Suppress prompts during interactive editing.
COMMANDS
If you omit the -A, -D, -L, and -LF options on the command line, EDPPO enters
an interactive editing session which accepts the following commands from
standard input.
a [name [fullname]]
Define one or more new names, along with optional full
name. If 'fullname' is omitted, EDPPO will prompt you for
it. Enter an empty line if you wish the fullname field to
be null. (See -A above for name formats and restrictions.)
If no name is specified, names are read from standard
input. We strongly recommend that you supply full names.
cf name new_fullname
Change the full name associated with the name indicated.
d name Delete the name indicated. Once deleted, the unique name
identifier cannot be recreated, so DELETE WITH EXTREME
CAUTION. Once you delete a name, no one can EVER access
any files created by the user who had that PPO. Normally,
you should delete people's accounts (using EDACCT), NOT
their names.
l [name] List one or all names defined (including new ones).
lf [name] List one or all names defined with their associated full
names, if any.
ln List only those names added during this editing session.
wr Update the file with the changes and exit.
q Quit without updating.
h [comm] Help -- list briefly all the available commands or a
particular command in detail.
EXAMPLES
List person names in the local registry.
$ edppo -loc -l
adm alan apgar beth bls
bso burt cas charlie chris
chrissy cmt col color csa
sqh sys_person taylor todd user
vic wilson_j zahn
$
RELATED TOPICS
More information is available. Type:
- HELP EDPPO COMMAND_NAME
for information on a particular interactive EDPPO command.
- HELP EDACCT
for details about creating network accounts.