unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

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 FOL-
       LOW_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 rep-
                       resent  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 owner-
                           name 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:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWnisu


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 SolarisTM Operat-
       ing Environment. Tools to aid the  migration  from  NIS+  to  LDAP  are
       available in the Solaris 9 operating environment. For more information,
       visit http://www.sun.com/directory/nisplus/transition.html.



SunOS 5.10                        10 Dec 2001                         nisln(1)