Manual Pages for UNIX Operating System command usage for man ypmap2src

System Administration Commands                      ypmap2src(1M)



NAME
     ypmap2src - convert NIS maps to NIS source files

SYNOPSIS
     /usr/lib/netsvc/yp/ypmap2src [-t]
          [ [-c custom-map-name]]... [-d domain] -o output-directory
          [ [ source-file]]...


DESCRIPTION
     Use the ypmap2src utility to convert standard  NIS  maps  to
     approximations  of  the  equivalent  NIS  source files. This
     utility functions like the reverse of ypmake(1M).


     The primary use for ypmap2src  is  to  convert  from  a  NIS
     server  that uses the NIS to LDAP(N2L) transition mechanism,
     which does not use NIS source  files,  to  traditional  NIS,
     where  source  files  are required. The ypmap2src utility is
     also used by NIS administrators who  wish  to  discover  the
     contents  of  NIS  maps for which the sources are not avail-
     able.


     Generally, this operation  is  not  necessary.  More  often,
     administrators  will  switch  from traditional NIS to N2L in
     anticipation of the eventual transition to LDAP naming. When
     this switch is made, authoritative information is moved into
     the LDAP DIT, and the NIS sources have no further role.  N2L
     supports  NIS  clients  until  such time as they can be con-
     verted to LDAP, and the NIS service suspended.


     The ypmap2src utility does not guarantee that the files that
     are  generated  are  identical  to  the  original NIS source
     files. Some information  might  have  been  thrown  away  by
     ypmake  and cannot be recovered. N2L also might have updated
     the maps to reflect changes made  by  LDAP  clients.  It  is
     essential  that the sources generated are checked to confirm
     no problems have occurred.


     Per entry comment fields, from existing  source  files,  are
     not  merged  into  source files generated by ypmap2src. If a
     user wishes N2L to maintain comment  information,  then  the
     NISLDAPmapping configuration file should be modified so that
     the comment fields are mapped into  LDAP. This  will  ensure
     that  the  comments  are  visible to native LDAP clients and
     present in the N2L map files.






SunOS 5.11          Last change: 10 Apr 2003                    1






System Administration Commands                      ypmap2src(1M)



     When ypmap2src is run, it will take up-to-date comments from
     the  map  file and insert them into the NIS source file gen-
     erated.

  Handling Custom Maps
     ypmap2src only knows about the standard NIS maps  and  stan-
     dard  source  to  map  conversion.  If  an advanced user has
     changed these, that  is,  the  user  has  modified  the  NIS
     makefile,  the  equivalent  changes must also be made to the
     ypmap2src script.

OPTIONS
     ypmap2src supports the following options:

     -c                Specifies that custom-map-name  should  be
                       converted  to a source        file by run-
                       ning makedbm -u on it. This is a short cut
                       so  that simple custom maps can be handled
                       without editing ypmap2src.


     -d domain-name     Specifies  the  domain  to  convert.  The
                       domain-name  can be a fully qualified file
                       path, such as  /var/yp/a.b.c,  or  just  a
                       domain        name,  a.b.c.  In the latter
                       case, ypmaptosrc looks in /var/yp for  the
                       domain directory.


     -o dest            Specifies the destination  directory  for
                       the  converted  files.  A  directory other
                       than /etc should be  specified.  The  maps
                       generated  are copied to the correct loca-
                       tion, /etc, /etc/security or other  source
                       directory, as appropriate.


     -t                Specifies  that  traditional   NIS   maps,
                       without N2L's LDAP_ prefix, should be con-
                       verted. By default, maps  with  the  LDAP_
                       prefix are converted.


OPERANDS
     ypmap2src supports the following operands:

     source-file    Lists the standard source files  to  convert.
                    If  this  option  is  not given, then all the
                    standard source files, plus any custom  files
                    pecified by the -c option, are converted.





SunOS 5.11          Last change: 10 Apr 2003                    2






System Administration Commands                      ypmap2src(1M)



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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | service/network/nis         |
    |_____________________________|_____________________________|
    | Interface Stability         | Obsolete                    |
    |_____________________________|_____________________________|


SEE ALSO
     ypmake(1M), ypserv(1M), NISLDAPmapping(4), attributes(5)



































SunOS 5.11          Last change: 10 Apr 2003                    3