nisln(1)							   User Commands							  nisln(1)

NAME

       nisln - symbolically link NIS+ objects

SYNOPSIS

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

DESCRIPTION

       The  nisln command links a NIS+ object named name to a NIS+ name linkname. If name is an indexed name (see nismatch(1)), the link points to
       entries within a 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(3NSL) for a description of the FOLLOW_LINKS flag).

       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(3NSL)) 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.

OPTIONS

       The following options are supported:

       -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 given object. The value
					 rights is specified in the  format  as  defined  by  the   nischmod(1)  command.  The	default  value	is
					 ----rmcdr---r---.

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

EXAMPLES

       Example 1 Creating a link

       In this example, we create a link in the domain foo.com. named hosts that points to the object hosts.bar.com.:

	 example% nisln hosts.bar.com. hosts.foo.com.

       Example 2 Making a link that points to an entry in the hosts table

       In this example, we make a link example.foo.com. that points to an entry in the hosts table in eng.foo.com:

	 example% nisln '[name=example],hosts.eng.foo.com.' example.foo.com.

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

EXIT STATUS

       The following exit values are returned:

       0    Successful operation.

       1    Operation failed.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWnisu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       nisdefaults(1), nismatch(1), nisrm(1), nistbladm(1), nis_names(3NSL), nis_tables(3NSL), attributes(5)

NOTES

       NIS+  might not be supported in future releases of the Solaris operating system. Tools to aid the migration from NIS+ to LDAP are available
       in the current Solaris release. For more information, visit http://www.sun.com/directory/nisplus/transition.html.

SunOS 5.11							    2 Dec 2005								  nisln(1)