Print this page
re #11781 rb3701 Update man related tools (add missed files)
re #11781 rb3701 Update man related tools
--HG--
rename : usr/src/cmd/man/src/THIRDPARTYLICENSE => usr/src/cmd/man/THIRDPARTYLICENSE
rename : usr/src/cmd/man/src/THIRDPARTYLICENSE.descrip => usr/src/cmd/man/THIRDPARTYLICENSE.descrip
rename : usr/src/cmd/man/src/man.c => usr/src/cmd/man/man.c
re #11201 nss: need local netgroup implementation
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/man/man1m/getent.1m.man.txt
+++ new/usr/src/man/man1m/getent.1m.man.txt
1 1 GETENT(1M) Maintenance Commands GETENT(1M)
2 2
3 3
4 4
5 5 NAME
6 6 getent - get entries from administrative database
7 7
8 8 SYNOPSIS
9 9 getent database [key]...
10 10
|
↓ open down ↓ |
10 lines elided |
↑ open up ↑ |
11 11
12 12 DESCRIPTION
13 13 getent gets a list of entries from the administrative database
14 14 specified by database. The information generally comes from one or more
15 15 of the sources that are specified for the database in
16 16 /etc/nsswitch.conf.
17 17
18 18
19 19 database is the name of the database to be examined. This can be
20 20 passwd, shadow, group, hosts, ipnodes, services, protocols, ethers,
21 - project, networks, or netmasks. For each of these databases, getent
22 - uses the appropriate library routines described in getpwnam(3C),
21 + project, networks, netmasks, or netgroup. For each of these databases,
22 + getent uses the appropriate library routines described in getpwnam(3C),
23 23 getspnam(3C), getgrnam(3C), gethostbyaddr(3NSL), gethostbyname(3NSL),
24 24 getipnodebyaddr(3SOCKET), getipnodebyname(3SOCKET),
25 25 getservbyname(3SOCKET), getprotobyname(3SOCKET), ethers(3SOCKET),
26 - getprojbyname(3PROJECT) and getnetbyname(3SOCKET), respectively.
26 + getprojbyname(3PROJECT), getnetbyname(3SOCKET), or getnetgrent(3C)
27 + respectively.
27 28
28 29
29 30 Each key must be in a format appropriate for searching on the
30 31 respective database. For example, it can be a username or numeric-uid
31 32 for passwd; hostname or IP address for hosts; or service,
32 33 service/protocol, port, or port/proto for services.
33 34
34 35
35 36 getent prints out the database entries that match each of the supplied
36 37 keys, one per line, in the format of the matching administrative file:
37 38 passwd(4), shadow(4), group(4), project(4), hosts(4), services(4),
38 39 protocols(4), ethers(3SOCKET), networks(4), or netmasks(4). If no key
39 40 is given, all entries returned by the corresponding enumeration library
40 41 routine, for example, getpwent() or gethostent(), are printed.
41 42 Enumeration is not supported on ipnodes.
42 43
43 44 Key Interpretation for passwd and group Databases
44 45 When getent is invoked with database set to passwd, each key value is
45 46 processed as follows:
46 47
47 48 o If the key value consists only of numeric characters, getent
48 49 assumes that the key value is a numeric user ID and searches
49 50 the user database for a matching user ID.
50 51
51 52 o If the user ID is not found in the user database or if the
52 53 key value contains any non-numeric characters, getent
53 54 assumes the key value is a user name and searches the user
54 55 database for a matching user name.
55 56
56 57
57 58 Similarly, when getent is invoked with database set to group, each key
58 59 value is processed as follows:
59 60
60 61 o If the key value consists only of numeric characters, getent
61 62 assumes that the key value is a numeric group ID and
62 63 searches the group database for a matching group ID.
63 64
64 65 o If the group ID is not found in the group database or if the
65 66 key value contains any non-numeric characters, getent
66 67 assumes the key value is a group name and searches the group
67 68 database for a matching group name.
68 69
69 70 EXIT STATUS
70 71 The following exit values are returned:
71 72
72 73 0
73 74 Successful completion.
74 75
75 76
76 77 1
77 78 Command syntax was incorrect, an invalid option was used, or an
78 79 internal error occurred.
79 80
80 81
81 82 2
82 83 At least one of the specified entry names was not found in the
83 84 database.
84 85
85 86
86 87 3
87 88 There is no support for enumeration on this database.
88 89
89 90
90 91 FILES
91 92 /etc/nsswitch.conf
92 93 name service switch configuration file
93 94
94 95
95 96 /etc/passwd
96 97 password file
97 98
98 99
99 100 /etc/shadow
100 101 shadowed password file
101 102
102 103
103 104 /etc/group
104 105 group file
105 106
106 107
107 108 /etc/inet/hosts
108 109 IPv4 and IPv6 host name database
109 110
110 111
111 112 /etc/services
112 113 Internet services and aliases
113 114
114 115
115 116 /etc/project
116 117 project file
117 118
118 119
119 120 /etc/protocols
120 121 protocol name database
121 122
122 123
123 124 /etc/ethers
124 125 Ethernet address to hostname database or domain
125 126
126 127
127 128 /etc/networks
128 129 network name database
129 130
130 131
131 132 /etc/netmasks
132 133 network mask database
133 134
134 135
135 136 SEE ALSO
136 137 ethers(3SOCKET), getgrnam(3C), gethostbyaddr(3NSL),
137 138 gethostbyname(3NSL), gethostent(3NSL), getipnodebyaddr(3SOCKET),
138 139 getipnodebyname(3SOCKET), getnetbyname(3SOCKET),
139 140 getprojbyname(3PROJECT), getprotobyname(3SOCKET), getpwnam(3C),
140 141 getservbyname(3SOCKET), group(4), hosts(4), netmasks(4), networks(4),
141 142 nsswitch.conf(4), passwd(4), project(4), protocols(4), services(4),
142 143 attributes(5)
143 144
144 145
145 146
146 147 March 14, 2014 GETENT(1M)
|
↓ open down ↓ |
110 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX