nischgrp(1) - osol9

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

NAME

6       nischgrp - change the group owner of a NIS+ object
7

SYNOPSIS

9       nischgrp [-AfLP] group name...
10
11

DESCRIPTION

13       nischgrp  changes the group owner of the NIS+ objects or entries speci‐
14       fied by name to the specified NIS+ group. Entries are  specified  using
15       indexed  names  (see  nismatch(1)).  If  group is not a fully qualified
16       NIS+ group name, it will be resolved using the  directory  search  path
17       (see nisdefaults(1)).
18
19
20       The  only  restriction on changing an object's group owner is  that you
21       must have modify permissions for the object.
22
23
24       This command will fail if the master NIS+ server is not running.
25
26
27       The  NIS+ server will check the validity of the  group  name  prior  to
28       effecting the  modification.
29

OPTIONS

31       The following options are supported:
32
33       -A    Modify  all  entries in all tables in the concatenation path that
34             match the search criterion specified in name. This option implies
35             the -P switch.
36
37
38       -f    Force the operation and fail silently if it does not succeed.
39
40
41       -L    Follow  links  and change the group owner of the linked object or
42             entries rather than the group owner of the link itself.
43
44
45       -P    Follow the concatenation path within a named table.  This  option
46             only  makes  sense  when either name is an indexed name or the -L
47             switch is also specified and the named object is a link  pointing
48             to entries.
49
50

EXAMPLES

52       Example 1 Using the nischgrp Command
53
54
55       The  following  two  examples  show how to change the group owner of an
56       object to a group in a different domain, and how  to  change  it  to  a
57       group in the local domain, respectively.
58
59
60         example% nischgrp newgroup.remote.domain. object
61         example% nischgrp my-buds object
62
63
64
65
66       This example shows how to change the group owner for a password entry.
67
68
69         example% nischgrp admins '[uid=99],passwd.org_dir'
70
71
72
73
74       In the previous example, admins is a NIS+ group in the same domain.
75
76
77
78       The  next  two examples change the group owner of the object or entries
79       pointed to by a link, and the group owner of all entries in the hobbies
80       table.
81
82
83         example% nischgrp -L my-buds linkname
84         example% nischgrp my-buds '[],hobbies'
85
86
87

ENVIRONMENT VARIABLES

89       NIS_PATH     If  this  variable  is set, and the NIS+ name is not fully
90                    qualified, each directory specified will be searched until
91                    the object is found (see nisdefaults(1)).
92
93

EXIT STATUS

95       The following exit values are returned:
96
97       0    Successful operation.
98
99
100       1    Operation failed.
101
102

ATTRIBUTES

104       See attributes(5) for descriptions of the following attributes:
105
106
107
108
109       ┌─────────────────────────────┬─────────────────────────────┐
110       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
111       ├─────────────────────────────┼─────────────────────────────┤
112       │Availability                 │SUNWnisu                     │
113       └─────────────────────────────┴─────────────────────────────┘
114

NOTES

120       NIS+ might not be supported in future releases of the Solaris operating
121       system.  Tools  to aid the migration from NIS+ to LDAP are available in
122       the   current   Solaris   release.   For   more   information,    visit
123       http://www.sun.com/directory/nisplus/transition.html.
124
125
126
127SunOS 5.11                        2 Dec 2005                       nischgrp(1)