nisln(1) - osol9

1nisln(1)                         User Commands                        nisln(1)
2
3
4

NAME

6       nisln - symbolically link NIS+ objects
7

SYNOPSIS

9       nisln [-L] [-D defaults] name linkname
10
11

DESCRIPTION

13       The  nisln  command  links  a  NIS+  object  named  name to a NIS+ name
14       linkname. If name is an indexed name (see nismatch(1)), the link points
15       to  entries within a NIS+ table. Clients wishing to look up information
16       in the name service can use the FOLLOW_LINKS flag to force  the  client
17       library  to follow links to the name they point to. Further, all of the
18       NIS+ administration commands  accept  the  -L  switch  indicating  they
19       should  follow links (see nis_names(3NSL) for a description of the FOL‐
20       LOW_LINKS flag).
21
22
23       When creating the link, nisln verifies that the linked  object  exists.
24       Once created, the linked object may be deleted or replaced and the link
25       will not be affected. At that time, the link will  become  invalid  and
26       attempts  to  follow  it  will return  NIS_LINKNAMEERROR to the client.
27       When the path attribute in tables specifies a link rather than  another
28       table,  the  link will be followed if the flag FOLLOW_LINKS was present
29       in the call to  nis_list() (see nis_tables(3NSL)) and  ignored  if  the
30       flag  is  not present. If the flag is present and the link is no longer
31       valid, a warning is sent to the system logger and the link is ignored.
32

OPTIONS

34       The following options are supported:
35
36       -D defaults    Specify a different set of defaults to be used  for  the
37                      creation  of  the  link object. The defaults string is a
38                      series of tokens separated by colons. These tokens  rep‐
39                      resent  the  default  values  to be used for the generic
40                      object properties. All of the legal tokens are described
41                      below.
42
43                      ttl=time           This  token  sets the default time to
44                                         live for objects that are created  by
45                                         this command. The value time is spec‐
46                                         ified in the format as defined by the
47                                         nischttl(1)  command.  The default is
48                                         12 hours.
49
50
51                      owner=ownername    This token specifies  that  the  NIS+
52                                         principal  ownername  should  own the
53                                         created object. The default for  this
54                                         value  is  the  the  principal who is
55                                         executing the command.
56
57
58                      group=groupname    This token specifies that  the  group
59                                         groupname  should  be the group owner
60                                         for the object that is  created.  The
61                                         default is NULL.
62
63
64                      access=rights      This   token  specifies  the  set  of
65                                         access rights that are to be  granted
66                                         for   the  given  object.  The  value
67                                         rights is specified in the format  as
68                                         defined  by the  nischmod(1) command.
69                                         The      default       value       is
70                                         −−−−rmcdr−−−r−−−.
71
72
73
74       -L             When  present,  this  option specifies that this command
75                      should follow links. If name is itself a link, then this
76                      command  will  follow  it  to  the linked object that it
77                      points to. The new link will point to that linked object
78                      rather than to name.
79
80

EXAMPLES

82       Example 1 Creating a link
83
84
85       In  this  example,  we create a link in the domain foo.com. named hosts
86       that points to the object hosts.bar.com.:
87
88
89         example% nisln hosts.bar.com. hosts.foo.com.
90
91
92
93       Example 2 Making a link that points to an entry in the hosts table
94
95
96       In this example, we make a link  example.foo.com.  that  points  to  an
97       entry in the hosts table in eng.foo.com:
98
99
100         example% nisln '[name=example],hosts.eng.foo.com.' example.foo.com.
101
102
103

ENVIRONMENT VARIABLES

105       NIS_PATH    If  this  variable  is  set, and the NIS+ name is not fully
106                   qualified, each directory specified will be searched  until
107                   the object is found (see nisdefaults(1)).
108
109

EXIT STATUS

111       The following exit values are returned:
112
113       0    Successful operation.
114
115
116       1    Operation failed.
117
118

ATTRIBUTES

120       See attributes(5) for descriptions of the following attributes:
121
122
123
124
125       ┌─────────────────────────────┬─────────────────────────────┐
126       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
127       ├─────────────────────────────┼─────────────────────────────┤
128       │Availability                 │SUNWnisu                     │
129       └─────────────────────────────┴─────────────────────────────┘
130

NOTES

136       NIS+ might not be supported in future releases of the Solaris operating
137       system.  Tools  to aid the migration from NIS+ to LDAP are available in
138       the   current   Solaris   release.   For   more   information,    visit
139       http://www.sun.com/directory/nisplus/transition.html.
140
141
142
143SunOS 5.11                        2 Dec 2005                          nisln(1)