1nischgrp(1) User Commands nischgrp(1)
2
3
4
6 nischgrp - change the group owner of a NIS+ object
7
9 nischgrp [-AfLP] group name...
10
11
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
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
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
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
95 The following exit values are returned:
96
97 0 Successful operation.
98
99
100 1 Operation failed.
101
102
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
116 NIS+[22m(1), nischmod(1), nischown(1), nisdefaults(1), nisgrpadm(1), nis‐
117 match(1), nis_objects(3NSL), attributes(5)
118
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)