Maintenance Commands                            rpc.yppasswdd(1M)

NAME
     rpc.yppasswdd, yppasswdd - server for modifying NIS password
     file

SYNOPSIS
     /usr/lib/netsvc/yp/rpc.yppasswdd   [   -D directory   ]    [
     -nogecos ]  [ -noshell ]  [ -nopw ]  [  -m argument1   argu-
     ment2 ...  ]

     /usr/lib/netsvc/yp/rpc.yppasswdd    [     passwordfile     [
     adjunctfile  ]   ]  [ -nogecos ]  [ -noshell ]  [ -nopw ]  [
     -m argument1   argument2 ...  ]

DESCRIPTION
     rpc.yppasswdd is  a  server  that  handles  password  change
     requests  from  yppasswd(1).  It changes a password entry in
     the passwd, shadow, and security/passwd.adjunct  files.  The
     passwd   and    shadow  files  provide  the  basis  for  the
     passwd.byname and passwd.byuid  maps.   The   passwd.adjunct
     file  provides  the basis for the  passwd.adjunct.byname and
     passwd.adjunct.byuid maps.  Entries in the passwd, shadow or
     passwd.adjunct  files  are  only  changed  if  the  password
     presented by yppasswd(1) matches the encrypted  password  of
     the  entry.  All  password  files  are located in the  PWDIR
     directory.

     If  the   -D  option  is  given,  the  passwd,  shadow,   or
     passwd.adjunct  files  are  located under the directory path
     specified with
      -D.

     If the  -noshell, -nogecos or -nopw options are given, these
     fields  may  not  be  changed  remotely using chfn, chsh, or
     passwd(1).

     If the -m option is given, a make(1) is performed in /var/yp
     after any of the passwd, shadow, or passwd.adjunct files are
     modified. Any arguments following the  flag  are  passed  to
     make.

     The second of the listed syntaxes is provided only for back-
     ward  compatibility.   If  the  second  syntax  is  used the
     passwordfile is the full pathname of the password  file  and
     adjunctfile   is   the   full   pathname   of  the  optional
     passwd.adjunct file.  If a shadow file is found in the  same
     directory  as   passwordfile  the   shadowfile  is  used  as
     described above.  Use of this syntax and the discovery of  a
     shadowfile  file  generates  diagnostic output.  The daemon,
     however, starts normally.

     The first and second syntaxes are mutually  exclusive.   You
     cannot   specify    the   full   pathname  of  the   passwd,

SunOS 5.8           Last change: 30 Jul 1998                    1

Maintenance Commands                            rpc.yppasswdd(1M)

     passwd.adjunct files and use the   -D  option  at  the  same
     time.

     The daemon is started automatically on the master server  of
     the   passwd   map   by   the  /etc/init.d/rpc  script  (see
     makedbm(1M))

     The server does not insist on the presence of a shadow  file
     unless there is no  -D option present or the directory named
     with the  -D option is  /etc. In addition, a  passwd.adjunct
     file  is  not  necessary.   If  the  -D option is given, the
     server attempts to find a passwd.adjunct file in the   secu-
     rity  subdirectory  of the named directory.  For example, in
     the presence of  ``-D /var/yp''  the  server  checks  for  a
     ``/var/yp/security/passwd.adjunct'' file.

     If there is only a  passwd file, then the encrypted password
     is expected in the second field.   If there is a  passwd and
     a  passwd.adjunct file, the encrypted password  is  expected
     in the second field of the adjunct  file with  ##username in
     the second field of the  passwd file.  If  all  three  files
     are  in use, the encrypted password is expected in the  sha-
     dow file.  Any deviation causes  a password update to fail.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWypu                     |
    |_____________________________|_____________________________|

SEE ALSO
     make(1),  passwd(1),  yppasswd(1),  inetd(1M),   ypmake(1M),
     passwd(4), shadow(4), ypfiles(4), attributes(5)

NOTES
     If  make has not been installed and the  -m option is given,
     the  daemon  outputs  a  warning  and  proceeds, effectively
     ignoring the  -m flag.

     When using the  -D option, you should  make  sure  that  the
     PWDIR of the  /var/yp/Makefile is set accordingly.

     The second listed syntax is supplied only for backwards com-
     patibility  and  may  be removed in a future release of this
     daemon.

SunOS 5.8           Last change: 30 Jul 1998                    2

Maintenance Commands                            rpc.yppasswdd(1M)

     The Network Information Service (NIS) was formerly known  as
     Sun Yellow Pages (YP).  The functionality of the two remains
     the same; only the name has changed.  The name Yellow  Pages
     is  a  registered trademark in the United Kingdom of British
     Telecommunications plc, and may not be used without  permis-
     sion.

SunOS 5.8           Last change: 30 Jul 1998                    3