getent.1 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230
  1. .rn '' }`
  2. ''' $RCSfile$$Revision$$Date$
  3. '''
  4. ''' $Log$
  5. '''
  6. .de Sh
  7. .br
  8. .if t .Sp
  9. .ne 5
  10. .PP
  11. \fB\\$1\fR
  12. .PP
  13. ..
  14. .de Sp
  15. .if t .sp .5v
  16. .if n .sp
  17. ..
  18. .de Ip
  19. .br
  20. .ie \\n(.$>=3 .ne \\$3
  21. .el .ne 3
  22. .IP "\\$1" \\$2
  23. ..
  24. .de Vb
  25. .ft CW
  26. .nf
  27. .ne \\$1
  28. ..
  29. .de Ve
  30. .ft R
  31. .fi
  32. ..
  33. '''
  34. '''
  35. ''' Set up \*(-- to give an unbreakable dash;
  36. ''' string Tr holds user defined translation string.
  37. ''' Bell System Logo is used as a dummy character.
  38. '''
  39. .tr \(*W-|\(bv\*(Tr
  40. .ie n \{\
  41. .ds -- \(*W-
  42. .ds PI pi
  43. .if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  44. .if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
  45. .ds L" ""
  46. .ds R" ""
  47. ''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
  48. ''' \*(L" and \*(R", except that they are used on ".xx" lines,
  49. ''' such as .IP and .SH, which do another additional levels of
  50. ''' double-quote interpretation
  51. .ds M" """
  52. .ds S" """
  53. .ds N" """""
  54. .ds T" """""
  55. .ds L' '
  56. .ds R' '
  57. .ds M' '
  58. .ds S' '
  59. .ds N' '
  60. .ds T' '
  61. 'br\}
  62. .el\{\
  63. .ds -- \(em\|
  64. .tr \*(Tr
  65. .ds L" ``
  66. .ds R" ''
  67. .ds M" ``
  68. .ds S" ''
  69. .ds N" ``
  70. .ds T" ''
  71. .ds L' `
  72. .ds R' '
  73. .ds M' `
  74. .ds S' '
  75. .ds N' `
  76. .ds T' '
  77. .ds PI \(*p
  78. 'br\}
  79. .\" If the F register is turned on, we'll generate
  80. .\" index entries out stderr for the following things:
  81. .\" TH Title
  82. .\" SH Header
  83. .\" Sh Subsection
  84. .\" Ip Item
  85. .\" X<> Xref (embedded
  86. .\" Of course, you have to process the output yourself
  87. .\" in some meaninful fashion.
  88. .if \nF \{
  89. .de IX
  90. .tm Index:\\$1\t\\n%\t"\\$2"
  91. ..
  92. .nr % 0
  93. .rr F
  94. .\}
  95. .TH GETENT 1 "July 2007" "Red Hat Linux"
  96. .UC
  97. .if n .hy 0
  98. .if n .na
  99. .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  100. .de CQ \" put $1 in typewriter font
  101. .ft CW
  102. 'if n "\c
  103. 'if t \\&\\$1\c
  104. 'if n \\&\\$1\c
  105. 'if n \&"
  106. \\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
  107. '.ft R
  108. ..
  109. .\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
  110. . \" AM - accent mark definitions
  111. .bd B 3
  112. . \" fudge factors for nroff and troff
  113. .if n \{\
  114. . ds #H 0
  115. . ds #V .8m
  116. . ds #F .3m
  117. . ds #[ \f1
  118. . ds #] \fP
  119. .\}
  120. .if t \{\
  121. . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  122. . ds #V .6m
  123. . ds #F 0
  124. . ds #[ \&
  125. . ds #] \&
  126. .\}
  127. . \" simple accents for nroff and troff
  128. .if n \{\
  129. . ds ' \&
  130. . ds ` \&
  131. . ds ^ \&
  132. . ds , \&
  133. . ds ~ ~
  134. . ds ? ?
  135. . ds ! !
  136. . ds /
  137. . ds q
  138. .\}
  139. .if t \{\
  140. . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  141. . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  142. . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  143. . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  144. . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
  145. . ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
  146. . ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
  147. . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
  148. . ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
  149. .\}
  150. . \" troff and (daisy-wheel) nroff accents
  151. .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
  152. .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
  153. .ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
  154. .ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
  155. .ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
  156. .ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
  157. .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
  158. .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
  159. .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
  160. .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
  161. .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
  162. .ds ae a\h'-(\w'a'u*4/10)'e
  163. .ds Ae A\h'-(\w'A'u*4/10)'E
  164. .ds oe o\h'-(\w'o'u*4/10)'e
  165. .ds Oe O\h'-(\w'O'u*4/10)'E
  166. . \" corrections for vroff
  167. .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
  168. .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
  169. . \" for low resolution devices (crt and lpr)
  170. .if \n(.H>23 .if \n(.V>19 \
  171. \{\
  172. . ds : e
  173. . ds 8 ss
  174. . ds v \h'-1'\o'\(aa\(ga'
  175. . ds _ \h'-1'^
  176. . ds . \h'-1'.
  177. . ds 3 3
  178. . ds o a
  179. . ds d- d\h'-1'\(ga
  180. . ds D- D\h'-1'\(hy
  181. . ds th \o'bp'
  182. . ds Th \o'LP'
  183. . ds ae ae
  184. . ds Ae AE
  185. . ds oe oe
  186. . ds Oe OE
  187. .\}
  188. .rm #[ #] #H #V #F C
  189. .SH "NAME"
  190. getent \- get entries from administrative database
  191. .SH "SYNOPSIS"
  192. \fBgetent\fR \fIdatabase\fR [\fIkey\fR ...]
  193. .SH "DESCRIPTION"
  194. The \fBgetent\fR program gathers entries from the specified
  195. administrative database using the specified search keys.
  196. \fIdatabase\fR is one of ahosts, ahostsv4, ahostsv6, aliases, ethers,
  197. group, hosts, netgroup, networks, passwd, protocols, rpc, services or
  198. shadow.
  199. .SH "EXIT STATUS"
  200. .IP 0
  201. Success; the requested entries were found.
  202. .IP 1
  203. Wrong number of or invalid arguments.
  204. .IP 2
  205. One or more of the requested entries could not be found.
  206. .IP 3
  207. Unsupported operation.
  208. .SH "AUTHOR"
  209. getent is written by Thorsten Kukuk for the GNU C Library.
  210. .PP
  211. This man page is written by Joel Klecker <espy@debian.org> for
  212. the Debian GNU/Linux system, updated by Jakub Jelinek <jakub@redhat.com>
  213. for GNU C Library 2.2.2 getent changes.
  214. .rn }` ''
  215. .IX Title "GETENT 1"
  216. .IX Name "getent - get entries from administrative database"
  217. .IX Header "NAME"
  218. .IX Header "SYNOPSIS"
  219. .IX Header "DESCRIPTION"
  220. .IX Header "EXIT STATUS"
  221. .IX Header "AUTHOR"