nisln(1)                                                           nisln(1)




 NAME    [Toc]    [Back]
      nisln - symbolically link NIS+ objects

 SYNOPSIS    [Toc]    [Back]
      nisln [ -L ] [ -D defaults ] name linkname

 DESCRIPTION    [Toc]    [Back]
      The nisln command links an NIS+ object named name to an NIS+ name
      linkname.  If name is an indexed name (see nismatch(1)), the link
      points to entries within an NIS+ table.  Clients wishing to look up
      information in the name service can use the FOLLOW_LINKS flag to force
      the client library to follow links to the name they point to. Further,
      all of the NIS+ administration commands accept the -L switch
      indicating they should follow links (see nis_names(3N) for a
      description of the FOLLOW_LINKS flag).

    Options    [Toc]    [Back]
      -L             When present, this option specifies that this command
                     should follow links.  If name is itself a link, then
                     this command will follow it to the linked object that
                     it points to.  The new link will point to that linked
                     object rather than to name.

      -D defaults    Specify a different set of defaults to be used for the
                     creation of the link object.  The defaults string is a
                     series of tokens separated by colons.  These tokens
                     represent the default values to be used for the generic
                     object properties.  All of the legal tokens are
                     described below.

                     ttl=time       This token sets the default time to live
                                    for objects that are created by this
                                    command. The value time is specified in
                                    the format as defined by the nischttl(1)
                                    command.  The default is 12 hours.

                     owner=ownername
                                    This token specifies that the NIS+
                                    principal ownername should own the
                                    created object. The default for this
                                    value is the the principal who is
                                    executing the command.

                     group=groupname
                                    This token specifies that the group
                                    groupname should be the group owner for
                                    the object that is created. The default
                                    is NULL.

                     access=rights  This token specifies the set of access
                                    rights that are to be granted for the



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 nisln(1)                                                           nisln(1)




                                    given object.  The value rights is
                                    specified in the format as defined by
                                    the nischmod(1) command.  The default
                                    value is ----rmcdr---r---.

    Notes    [Toc]    [Back]
      When creating the link, nisln verifies that the linked object exists.
      Once created, the linked object may be deleted or replaced and the
      link will not be affected.  At that time the link will become invalid
      and attempts to follow it will return NIS_LINKNAMEERROR to the client.
      When the path attribute in tables specifies a link rather than another
      table, the link will be followed if the flag FOLLOW_LINKS was present
      in the call to nis_list () (see nis_tables(3N)) and ignored if the
      flag is not present.  If the flag is present and the link is no longer
      valid, a warning is sent to the system logger and the link is ignored.

 EXAMPLES    [Toc]    [Back]
      Create a link in the domain foo.com.  named hosts that points to the
      object hosts.bar.com:

           nisln hosts.bar.com. hosts.foo.com.

      Make a link example.sun.com. that points to an entry in the hosts
      table in eng.sun.com.:

           nisln '[name=example],hosts.eng.sun.com.' example.sun.com:

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      NIS_PATH       If this variable is set and the NIS+ name is not fully
                     qualified, each directory specified will be searched
                     until the object is found (see nisdefaults(1)).

 RETURN VALUE    [Toc]    [Back]
      nisln returns 0 on success and 1 on failure.

 WARNINGS    [Toc]    [Back]
      HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is
      supported.

      LDAP is the recommended replacement for NIS+.  HP fully supports the
      industry standard naming services based on LDAP.

 AUTHOR    [Toc]    [Back]
      nisln was developed by Sun Microsystems, Inc.

 SEE ALSO    [Toc]    [Back]
      nisdefaults(1), nismatch(1), nisrm(1), nistbladm(1), nis_names(3N),
      nis_tables(3N).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003