2.0;edppo (edit_ppo_file),revision 2.0, 83/02/03
EDPPO (EDIT_PPO) -- Edit or 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 user names in the network registry.  This is a
  prelude to creating network accounts, which associate user names 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 user name and account.

  For detailed examples of editing network registry files and complete
  information on network registry commands, see the "DOMAIN System
  Administrator's Guide."



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.  If this option
                   is omitted, EDPPO uses the network registry file copy
                   ('/registry/registry') on the current node to locate the
                   network registry, unless -LOC is specified.

  -LOC             Specify that the node's local registry ('/registry/
                   local_registry') is to be edited or listed.  If -LOC is
                   specified, the only other valid options are -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 underscore (_).  PPO names
                   are automatically maintained in lowercase.   Associated full
                   name text is optional.  It can include any characters and be
                   up to 32 characters long.  Use single (or double) quotes to
                   embed spaces (or quotes) 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 JUDICIOUSLY, even
                   locally, since a unique name identifier cannot be recreated
                   once it has been deleted.  Normally, peoples' accounts should
                   be deleted (with 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.

  cf name new_fullname
                   Change the full name associated with the name indicated.

  d name           Delete the name indicated.   Once deleted, the name
                   identifier can NOT be recreated.  DELETE JUDICIOUSLY.
                   Normally, people's accounts should be deleted (with 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.


EXAMPLE

  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.