"Fossies" - the Fresh Open Source Software Archive

Member "nss-pam-ldapd-0.9.12/man/getent.ldap.1" (20 Nov 2021, 4832 Bytes) of package /linux/privat/nss-pam-ldapd-0.9.12.tar.gz:

    1 '\" -*- coding: utf-8 -*-
    2 .if \n(.g .ds T< \\FC
    3 .if \n(.g .ds T> \\F[\n[.fam]]
    4 .de URL
    5 \\$2 \(la\\$1\(ra\\$3
    6 ..
    7 .if \n(.g .mso www.tmac
    8 .TH getent.ldap 1 "Nov 2021" "Version 0.9.12" "User Commands"
    9 .SH NAME
   10 getent.ldap \- query information from LDAP
   11 .SH SYNOPSIS
   12 'nh
   13 .fi
   14 .ad l
   15 \fBgetent.ldap\fR \kx
   16 .if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
   17 'in \n(.iu+\nxu
   18 [\fIoptions\fR] [\fIDATABASE\fR] [\fIKEY...\fR]
   19 'in \n(.iu-\nxu
   20 .ad b
   21 'hy
   22 .SH DESCRIPTION
   23 The \fBgetent.ldap\fR command can be used to lookup or
   24 enumerate information from LDAP.
   25 Unlike the
   26 \fBgetent\fR(1)
   27 command, this command completely bypasses the lookups configured in
   28 \*(T<\fI/etc/nsswitch.conf\fR\*(T> and queries the
   29 \fBnslcd\fR(8)
   30 daemon directly.
   31 .PP
   32 \fBgetent.ldap\fR tries to match the behaviour and output of
   33 \fBgetent\fR and the format in the corresponding flat files
   34 as much as possible, however there are a number of differences.
   35 If multiple entries are found in LDAP that match a
   36 specific query, multiple values are printed (e.g. ethernet addresses that
   37 have multiple names, services that support multiple protocols, etc.).
   38 Also, some databases have extra options as described below.
   39 .SH OPTIONS
   40 The options that may be specified to the \fBgetent.ldap\fR
   41 command are:
   42 .TP 
   43 \*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T> 
   44 Display short help and exit.
   45 .TP 
   46 \*(T<\fB\-V, \-\-version\fR\*(T> 
   47 Output version information and exit.
   48 .SH DATABASES
   49 The \fIDATABASE\fR argument may be any of the
   50 supported databases below:
   51 .TP 
   52 \*(T<\fBaliases\fR\*(T>
   53 Lists or queries email aliases.
   54 If \fIKEY\fR is given it searches for the alias
   55 by name, otherwise it returns all aliases from
   56 LDAP.
   57 .TP 
   58 \*(T<\fBethers\fR\*(T>
   59 Lists or queries ethernet addresses.
   60 If \fIKEY\fR matches the format of an ethernet
   61 address a search by address is performed, otherwise a search by name
   62 is performed or all entries are returned if
   63 \fIKEY\fR is omitted.
   64 Unlike \fBgetent\fR, \fBgetent.ldapd\fR
   65 does support enumerating all ethernet addresses.
   66 .TP 
   67 \*(T<\fBgroup\fR\*(T>
   68 Lists or queries groups.
   69 If \fIKEY\fR is numeric, it searches for the
   70 group by group id.
   71 .TP 
   72 \*(T<\fBgroup.bymember\fR\*(T>
   73 The \fIKEY\fR is a user name and groups are
   74 returned for which this user is a member.
   75 The format is similar to the \*(T<\fBgroup\fR\*(T> output but the
   76 group members are left out for performance reasons.
   77 .TP 
   78 \*(T<\fBhosts\fR\*(T>
   79 List or search host names and addresses by either host name,
   80 IPv4 or IPv6 address. This returns both IPv4 and IPv6 addresses
   81 (if available).
   82 .TP 
   83 \*(T<\fBhostsv4\fR\*(T>
   84 Similar to \*(T<\fBhosts\fR\*(T> but any supplied IPv6 addresses are
   85 treated as host names and only IPv4 addresses are returned.
   86 .TP 
   87 \*(T<\fBhostsv6\fR\*(T>
   88 Similar to \*(T<\fBhosts\fR\*(T> but \fIKEY\fR
   89 is treated as an IPv6 address or a host name and only IPv6 addresses
   90 are returned.
   91 .TP 
   92 \*(T<\fBnetgroup\fR\*(T>
   93 List or query netgroups and netgroup triples (host, user, domain) that
   94 are a member of the netgroup.
   95 Unlike \fBgetent\fR, \fBgetent.ldapd\fR
   96 does support enumerating all ethernet addresses.
   97 .TP 
   98 \*(T<\fBnetgroup.norec\fR\*(T>
   99 Similar to \*(T<\fBnetgroup\fR\*(T> except that no subsequent
  100 lookups are done to expand netgroups which are member of the
  101 supplied netgroup and the output may contain both other netgroup
  102 names and netgroup triples.
  103 .TP 
  104 \*(T<\fBnetworks\fR\*(T>
  105 List or query network names and addresses.
  106 \fIKEY\fR may be a network name or address.
  107 This map can return both IPv4 and IPv6 network addresses.
  108 .TP 
  109 \*(T<\fBnetworksv4\fR\*(T>
  110 Only return IPv4 network addresses.
  111 .TP 
  112 \*(T<\fBnetworksv6\fR\*(T>
  113 Only return IPv6 network addresses.
  114 .TP 
  115 \*(T<\fBpasswd\fR\*(T>
  116 Enumerate or search the user account database.
  117 \fIKEY\fR may be a user name or numeric user id
  118 or be omitted to list all users.
  119 .TP 
  120 \*(T<\fBprotocols\fR\*(T>
  121 Enumerate the internet protocols database.
  122 .TP 
  123 \*(T<\fBrpc\fR\*(T>
  124 List or search user readable names that map to RPC program numbers.
  125 Searching by \fIKEY\fR can be done on name or
  126 rpc program number.
  127 .TP 
  128 \*(T<\fBservices\fR\*(T>
  129 List or search the mapping between names for internet services and
  130 their corresponding port numbers and protocol types.
  131 The \fIKEY\fR can be either a service name or
  132 number, followed by an optional slash and protocol name to restrict
  133 the search to only entries for the specified protocol.
  134 .TP 
  135 \*(T<\fBshadow\fR\*(T>
  136 Enumerate or search extended user account information.
  137 Note that shadow information is likely only exposed to the root user
  138 and by default \fBnslcd\fR does not expose password
  139 hashes, even to root.
  140 .SH "SEE ALSO"
  141 \fBgetent\fR(1),
  142 \fBnslcd\fR(8)
  143 .SH AUTHOR
  144 This manual was written by Arthur de Jong <arthur@arthurdejong.org>.
  145 .SH BUGS
  146 Currently, \fBgetent.ldapd\fR does not correctly set an
  147 exit code. It should return the same kind of exit codes as
  148 \fBgetent\fR does (e.g. for missing entries).