Annotation of 43BSDReno/contrib/isode-beta/doc/whitepages/user/quick.tex, revision 1.1.1.1

1.1       root        1: % -*- LaTeX -*-
                      2: 
                      3: \input lcustom
                      4: 
                      5: \documentstyle[10pt]{article}
                      6: 
                      7: \advance\textwidth by1in
                      8: \advance\oddsidemargin by-0.5in
                      9: \advance\evensidemargin by-0.5in
                     10: 
                     11: \pagestyle{empty}
                     12: 
                     13: \begin{document}
                     14: 
                     15: \begin{center}\LARGE\bf
                     16: WHITE PAGES\\ 
                     17: \large\bf QUICK REFERENCE SHEET
                     18: \end{center}
                     19: 
                     20: \section*      {Query Syntax}
                     21: \begin{verbatim}
                     22: whois input-field [record-type] [area-designator] [output-control]
                     23:     input-field is one of:
                     24:         name NAME               e.g., surname "smith", or fullname "john smith"
                     25:         handle HANDLE           e.g., handle @c=US@cn=Manager
                     26:         mailbox LOCAL@DOMAIN    e.g., mailbox [email protected]
                     27: 
                     28:     record-type is one of:
                     29:         person or -title NAME   e.g., -title scientist
                     30:         organization
                     31:         unit (a division under an organization)
                     32:         role (a role within an organization)
                     33:         locality
                     34:         dsa (white pages server)
                     35: 
                     36:     area-designator is one of:
                     37:         -org NAME               e.g., -org nyser
                     38:         -unit NAME              e.g., -unit engineering
                     39:         -locality NAME          e.g., -locality rensselaer
                     40:         -area HANDLE            e.g., -area "@c=US@o=NYSERNet Inc."
                     41:             and may be followed by -geo HANDLE, e.g., -geo @c=GB
                     42: 
                     43:     output-control is any of:
                     44:         expand     - give a detailed listing, followed by children
                     45:         subdisplay - give a one-listing listing, followed by children
                     46:         full       - give a detailed listing, even on ambiguous matches
                     47:         summary    - give a one-line listing, even on unique matches
                     48: \end{verbatim}
                     49: \vfill\noindent
                     50: The most common usage:
                     51: \begin{quote}\small\begin{verbatim}
                     52: fred> whois schoffstall -org psi
                     53: Trying @c=US@o=Performance Systems International ...
                     54: 3 matches found.
                     55:   2. Marvin Schoffstall                         [email protected]
                     56:   3. Martin Schoffstall                         [email protected]
                     57:   4. Steve Schoffstall                          [email protected]
                     58: 
                     59: fred> whois !3
                     60: Martin Schoffstall (3)                          [email protected]
                     61:     ...
                     62: \end{verbatim}\end{quote}
                     63: 
                     64: \newpage
                     65: 
                     66: \section*      {Examples of usage}
                     67: \begin{verbatim}
                     68: fred> whois "smith"
                     69: \end{verbatim}
                     70: \begin{quote}
                     71: looks for any entries with this name in the default area
                     72: (choice of matching on the entry's surname or fullname is based on the value
                     73: of the \verb"namesearch" variable)
                     74: \end{quote}
                     75: 
                     76: \begin{verbatim}
                     77: fred> whois surname "smith"
                     78: \end{verbatim}
                     79: \begin{quote}
                     80: looks for any entries with this name in the default area
                     81: \end{quote}
                     82: 
                     83: \begin{verbatim}
                     84: fred> whois fullname "john smith"
                     85: \end{verbatim}
                     86: \begin{quote}
                     87: looks for any entries with this name in the default area
                     88: \end{quote}
                     89: 
                     90: \begin{verbatim}
                     91: fred> whois "smith" -org nyser
                     92: \end{verbatim}
                     93: \begin{quote}
                     94: looks for any entries with this name in any organization containing ``nyser''
                     95: \end{quote}
                     96: 
                     97: \begin{verbatim}
                     98: fred> whois "smith" -area "@c=US@o=NYSERNet Inc."
                     99: \end{verbatim}
                    100: \begin{quote}
                    101: could be used if you already know the "area" that the user resides in
                    102: \end{quote}
                    103: 
                    104: \begin{verbatim}
                    105: fred> whois "smith" -area 17
                    106: \end{verbatim}
                    107: \begin{quote}
                    108: could be used if an alias were already established for this area
                    109: \end{quote}
                    110: 
                    111: \begin{verbatim}
                    112: fred> whois @c=US@cn=Manager
                    113: \end{verbatim}
                    114: \begin{quote}
                    115: looks for the entry with this distinguished name (handle)
                    116: \end{quote}
                    117: 
                    118: \begin{verbatim}
                    119: fred> whois !7
                    120: \end{verbatim}
                    121: \begin{quote}
                    122: could be used if an alias were already established for this entry
                    123: \end{quote}
                    124: 
                    125: \begin{verbatim}
                    126: fred> whois [email protected]
                    127: \end{verbatim}
                    128: \begin{quote}
                    129: looks for any entries with the given mailbox
                    130: \end{quote}
                    131: 
                    132: \begin{verbatim}
                    133: fred> whois -title operator
                    134: \end{verbatim}
                    135: \begin{quote}
                    136: looks for any entries who are operators
                    137: \end{quote}
                    138: 
                    139: \begin{verbatim}
                    140: fred> whois -org *
                    141: \end{verbatim}
                    142: \begin{quote}
                    143: reports on all registered organizations
                    144: \end{quote}
                    145: 
                    146: \begin{verbatim}
                    147: fred> whois -org * -geo @c=GB
                    148: \end{verbatim}
                    149: \begin{quote}
                    150: reports on all registered organizations under @c=GB
                    151: \end{quote}
                    152: 
                    153: \end{document}

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.