unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 nisln(1)							    nisln(1)




 NAME
      nisln - symbolically link NIS+ objects

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

 DESCRIPTION
      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
      -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 Release 11i: November 2000






 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---.

 EXAMPLES
      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
    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
      nisln returns 0 on success and 1 on failure.

 AUTHOR
      nisln was developed by Sun Microsystems, Inc.

 SEE ALSO
      nisdefaults(1), nismatch(1), nisrm(1), nistbladm(1), nis_names(3N),
      nis_tables(3N).

 NOTES
      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.












 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000