fncopy(1M)

NAME

     fncopy - copy FNS contexts, possibly from one naming service
     to another naming service

SYNOPSIS

     fncopy   [-f filename]   [-i old-naming-service]    [-o new-
     naming-service] old-fns-context new-fns-context

DESCRIPTION

     fncopy copies recursively the FNS context,  old-fns-context,
     and  attributes to a new FNS context, new-fns-context. If -i
     and -o options are specified with the respective naming ser-
     vice,  the  old-fns-context  with  be  resolved  using  old-
     naming-service as the underlying naming  service,  and  new-
     fns-context  will be created using new-naming-service as the
     underlying naming service. In  the  absence  of  -i  and  -o
     options,  the  default  naming  service  will  be  used (see
     fnselect(1M)).

     When the -f option is used, filename names a file containing
     a  list  of  contexts  in the old-fns-context that should be
     copied to the new-fns-context.

     If the FNS context new-fns-context  already  exists  in  the
     target naming service, new-naming-service, this command will
     copy only the contexts and bindings that do not exist in the
     target naming service. This command will not  over-write any
     of the existing FNS contexts in the target naming service.

     This command follows links  and  copies   FNS  contexts  and
     binding to the new-fns-context namespace.

OPTIONS

     The following options are supported:

     -f filename
           Specifies a file name that contains a list of FNS con-
           texts to be copied.

     -i old-naming-service
           Specifies the source naming  service;  currently  only
           nis is supported.

     -o new-naming-service
           Specifies the target naming  service;  currently  only
           nisplus is supported.

OPERANDS

     The following operands are supported:

     new-fns-context
           The new FNS context.

     old-fns-context
           The current FNS context.

EXAMPLES

     Example 1: Copying the fncopy FNS Printer Context

     The  following  command  copies  the  FNS  printer   context
     .../fed-naming.eng.sun.com/service/printer  and  its subcon-
     texts   and   bindings   to   the   FNS   printer    context
     .../sun.com/orgunit/ssi.eng/service/printer.

     % fncopy .../fed-naming.eng.sun.com/service/printer \
          .../sun.com/orgunit/ssi.eng/service/printer

     Example 2: Copying the NIS FNS Users' Contexts

     The following command copies the  NIS  FNS  users'  contexts
     specified in the file /etc/ssi-users-list to NIS+ FNS users'
     context of the orgunit ssi.eng:

     % fncopy -i nis -o nisplus -f /etc/ssi-users-list \
          thisorgunit/user org/ssi.eng/user

EXIT STATUS

     0     Operation was successful.

     1     Operation failed.

ATTRIBUTES

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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWfns                     |
    |_____________________________|_____________________________|

SEE ALSO

     fnbind(1),   fnunbind(1),   fncreate(1M),   fncreate_fs(1M),
     fncreate_printer(1M), fndestroy(1M), attributes(5), fns(5)