Provided by: debathena-moira-clients_4.0.0+svn20100405-0debathena1~ubuntu10.04_i386 bug

NAME

       stanley - examine and modify information about users in Moira

SYNOPSIS

       stanley username [options]

DESCRIPTION

       Stanley  is  a  tool  for updating information about users in Moira. It
       supports all user modification commands and a  few  options  to  change
       user reservations.

       If no options are specified, it will assume -info, which will result in
       all information about the specified user being displayed.

OPTIONS

       -info or -i
              Display information about a user. This is the default mode if no
              other options are given. The output is similar to that of moira.

       -addreservation reservation or -ar reservation
              This  will  add  the reservation reservation for the user.  This
              option  can  be  specified   multiple   times   with   different
              reservations on the same command line.

       -deletereservation reservation or -dr reservation
              This will remove the reservation reservation for the given user.
              This option can  be  specified  multiple  times  with  different
              reservations on the same command line.

       -listreservation or -lr
              This will list reservations for the specified user.

       -uid uid or -u uid
              Update the uid field for the specified user to uid.

       -shell shell or -s shell
              Update the shell field for the specified user to shell.

       -winshell winshell or -w winshell
              Update the winshell field for the specified user to winshell.

       -status status or -S status
              Update the status field for the specified user to status.

       -first firstname or -F firstname
              Change the first name of the given user to firstname.

       -last lastname or -L lastname
              Change the last name of the given user to lastname.

       -middle middlename or -M middlename
              Change the middle name of the given user to middlename.

       -mitid mitid or -I mitid
              Change the MIT ID number of the given user to mitid.

       -class class or -cl class
              Change the class of the given user to class.

       -comment comment or -c comment
              Update the comment for the given user to comment.

       -secure 0|1 or -6 0|1
              Change  whether  a  user  requires  a  secure  Account Coupon to
              register for an account.

       -sponsor sponsor or -sp sponsor
              Set the sponsor of the specified user to sponsor.  This field is
              intended to be used for accounts in the GUEST and VOUCH classes.

       -expiration date or -e date
              Set  the  expiration  date for the specified user to date.  This
              field is intended to be used for accounts in the GUEST and VOUCH
              classes.

       -unformatted or -u
              Display  user information with each field on a seperate line, in
              the form "fieldname: value".

       -verbose or -v
              Give more information.  With this flag, stanley will display the
              queries it is making to the moira server.

       -noauth or -n
              Do not attempt to perform Kerberos authentication with the Moira
              server.  Most lookup operations should be still possible without
              tickets.

       -database host:port or -db host:port
              Use  the  specified  host and port to contact the Moira database
              instead of the default server.  Both may be  symbolic  names  or
              numbers.  If the port is left off, the default Moira server port
              will be assumed.  The database chosen will be the one  specified
              on  the  command  line, specified in the MOIRASERVER environment
              variable, the hesiod "moira" sloc  entry,  or  the  compiled  in
              default, in that order or preference.

       -create or -C
              This  will  create the specified user, with information provided
              by other options. By default, the user will be be status 0,  and
              will be assigned a unique username and uid, and will not require
              an Account Coupon to register.

       -deact or -D
              This will deactivate the specified user, as well as the matching
              list and filesystem, assuming they exist.

       -rename newname or -R newname
              This will rename the given user to newname.

       -register or -r
              This will register the specified username, creating a filesystem
              and  assigning  a  PO  Box.   It  will  not  create  a  Kerberos
              principal.   A  status 0 user will be status 2 after having been
              registered in this way, and the user will still need to use  the
              registration  applet to set an initial password.  Status 6 users
              will be status 1 and  have  full  Athena  accounts  after  being
              registered.

AUTHORS

       Garry Zacheiss, MIT Information Systems.

SEE ALSO

       moira(1)

DIAGNOSTICS

       An  exit status of 2 indicates a problem contacting the server. An exit
       status of 1 indicates that the arguments could not be  parsed  or  some
       query  to  the  moira  server  returned  an  error. An exit status of 0
       indicates that all operations requested completed successfully.

NOTES

       The username doesn't actually have to be the first argument, but if you
       put it anywhere else, it's easy to get the other arguments in the wrong
       order and do something other than what you intended.