HP-UX Reference (11i v2 04/09) - 1 User Commands N-Z (vol 2)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

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.Ifname 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 ﬂag 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 ﬂag).

Options

-L When present, this option speciﬁes 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 speciﬁed in the format as deﬁned by the

nischttl (1) command. The default is 12 hours.

owner=ownername

This token speciﬁes that the NIS+ principal ownername should own the

created object. The default for this value is the the principal who is exe-

cuting the command.

group=groupname

This token speciﬁes that the group groupname should be the group

owner for the object that is created. The default is NULL.

access=rights

This token speciﬁes the set of access rights that are to be granted for the

given object. The value rights is speciﬁed in the format as deﬁned by the

nischmod(1) command. The default value is - - - -rmcdr- - -r- - -

Notes

When creating the link,

nisln veriﬁes 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

speciﬁes a link rather than another table, the link will be followed if the ﬂag

FOLLOW_LINKS was

present in the call to nis_list ( ) (see nis_tables (3N)) and ignored if the ﬂag is not present. If the ﬂag

is present and the link is no longer valid, a warning is sent to the system logger and the link is ignored.

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 qualiﬁed, each directory speciﬁed

will be searched until the object is found (see nisdefaults (1)).

RETURN VALUE

nisln returns 0 on success and 1 on failure.

Section 1−−654 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: September 2004