Return to attributes.tex CVS log

Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / doc / whitepages / user

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

1.1     ! root        1: % run this through LaTeX with the appropriate wrapper
        !             2: 
        !             3: \chapter      {Attributes for Persons in the Pilot Project}%
        !             4:                \label{person:attributes}
        !             5: Here is the list of the attributes which may be present for a person
        !             6: represented in the NYSERNet/PSI White Pages Pilot Project.
        !             7: 
        !             8: There are two mandatory attributes:
        !             9: \begin{describe}
        !            10: \item[commonName:]
        !            11:                        which gives a (potentially ambiguous) name for
        !            12:                        the person.
        !            13:                        The value of this attribute is a string usually
        !            14:                        containing the person's first and last names; e.g.,
        !            15: \begin{quote}\small\begin{verbatim}
        !            16: Marshall Rose
        !            17: \end{verbatim}\end{quote}
        !            18:                        This attribute is usually multi-valued, containing
        !            19:                        variations on the first, middle, and last names; e.g.,
        !            20: \begin{quote}\small\begin{verbatim}
        !            21: Colin Robbins
        !            22: Colin John Robbins
        !            23: Colin J. Robbins
        !            24: \end{verbatim}\end{quote}
        !            25:                        For purposes of the pilot project, the distinguished
        !            26:                        value of the attribute should contain only the
        !            27:                        person's first and last names.
        !            28: 
        !            29: \item[surName:]
        !            30:                        which gives the person's last name.
        !            31:                        The value of this attribute is a string; e.g.,
        !            32: \begin{quote}\small\begin{verbatim}
        !            33: Rose
        !            34: \end{verbatim}\end{quote}
        !            35: \end{describe}
        !            36: There are several attributes that may be present,
        !            37: which are divided into five groups:
        !            38: physical address, telecommunication information, 
        !            39: computer environment,
        !            40: miscellaneous information,
        !            41: and home information.
        !            42: 
        !            43: The first group describes the physical address of the object:
        !            44: \begin{describe}
        !            45: \item[postalAddress:]
        !            46:                        which describes how physical mail is addressed to the
        !            47:                        object.
        !            48:                        The syntax of this attribute's value is special:
        !            49:                        it consists of~1 to~6 fields, seperated by the
        !            50:                        ``\verb"$"''-sign, each field being from~1 to~30
        !            51:                        characters long; e.g.
        !            52: \begin{quote}\small\begin{verbatim}
        !            53: NYSERNet Inc. $ 165 Jordan Road $ Troy, NY 12180
        !            54: \end{verbatim}\end{quote}
        !            55: 
        !            56: \item[registeredAddress:]
        !            57:                        which defines how registered physical mail is
        !            58:                        addressed to the object.
        !            59:                        The syntax is identical to that of the
        !            60:                        \verb"postalAddress" attribute.
        !            61: 
        !            62: \item[roomNumber:]
        !            63:                        which is a string describing where the object resides
        !            64:                        at the location, e.g.,
        !            65: \begin{quote}\small\begin{verbatim}
        !            66: Building T-30
        !            67: \end{verbatim}\end{quote}
        !            68: 
        !            69: \item[streetAddress:]
        !            70:                        which is a string describing where the object
        !            71:                        physically resides
        !            72:                        (i.e., the street name, place, avenue, and building
        !            73:                        number); e.g.,
        !            74:                        object
        !            75: \begin{quote}\small\begin{verbatim}
        !            76: 165 Jordan Road
        !            77: \end{verbatim}\end{quote}
        !            78:                        This need have no relationship to the object's
        !            79:                        postal address.
        !            80: 
        !            81: \item[postOfficeBox:]
        !            82:                        which is a string describing the box at which the
        !            83:                        object will receive physical postal delivery; e.g.,
        !            84: \begin{quote}\small\begin{verbatim}
        !            85: 1010
        !            86: \end{verbatim}\end{quote}
        !            87: 
        !            88: \item[physicalDeliveryOfficeName:]
        !            89:                        which is a string describing the geographical location
        !            90:                        of the physical delivery office which services the
        !            91:                        postal address of this object; e.g.,
        !            92: \begin{quote}\small\begin{verbatim}
        !            93: Troy
        !            94: \end{verbatim}\end{quote}
        !            95: 
        !            96: \item[stateOrProvinceName:]
        !            97:                        which is a string describing the state in which
        !            98:                        the \verb"locality" is found; e.g.,
        !            99: \begin{quote}\small\begin{verbatim}
        !           100: New York
        !           101: \end{verbatim}\end{quote}
        !           102: 
        !           103: \item[postalCode:]
        !           104:                        which is a string containing the ZIP code; e.g.,
        !           105: \begin{quote}\small\begin{verbatim}
        !           106: 12180
        !           107: \end{verbatim}\end{quote}
        !           108: or
        !           109: \begin{quote}\small\begin{verbatim}
        !           110: 94043-2112
        !           111: \end{verbatim}\end{quote}
        !           112: 
        !           113: \item[localityName:]
        !           114:                        which is a string describing the geographical
        !           115:                        area containing the \verb"streetAddress"; e.g.,
        !           116: \begin{quote}\small\begin{verbatim}
        !           117: Troy, New York
        !           118: \end{verbatim}\end{quote}
        !           119: \end{describe}
        !           120: The second optional group describes telecommunications addressing information
        !           121: for the object.
        !           122: \begin{describe}
        !           123: \item[telephoneNumber:]
        !           124:                which is a string describing the phone number of the object
        !           125:                using the international notation; e.g.,
        !           126: \begin{quote}\small\begin{verbatim}
        !           127: +1 518-283-8860
        !           128: \end{verbatim}\end{quote}
        !           129: 
        !           130: \item[facsimileTelephoneNumber:]
        !           131:                which is a string describing the fax number of the object
        !           132:                using the international notation; e.g.,
        !           133: \begin{quote}\small\begin{verbatim}
        !           134: +1 518-283-8904
        !           135: \end{verbatim}\end{quote}
        !           136: 
        !           137: \item[telexNumber:]
        !           138:                which is defines the TELEX address of the object in a
        !           139:                three-part string:
        !           140: \begin{quote}\small\begin{verbatim}
        !           141: number $ country $ answerback
        !           142: \end{verbatim}\end{quote}
        !           143:                e.g.,
        !           144: \begin{quote}\small\begin{verbatim}
        !           145: 650 103 7390 $ US $ MCI UW
        !           146: \end{verbatim}\end{quote}
        !           147: \end{describe}
        !           148: The third group describes information relating to the person's
        !           149: computer environment:
        !           150: \begin{describe}
        !           151: \item[rfc822Mailbox:]
        !           152:                        which is the user's computer mail address,
        !           153:                        e.g., 
        !           154: \begin{quote}\small\begin{verbatim}
        !           155: [email protected]
        !           156: \end{verbatim}\end{quote}
        !           157: 
        !           158: \item[otherMailbox:]
        !           159:                        which is the user's computer mail address
        !           160:                        in various domains.
        !           161:                        The syntax of this attribute's value is special:
        !           162: \begin{quote}\small\begin{verbatim}
        !           163: <domain> $ <mailbox>
        !           164: \end{verbatim}\end{quote}
        !           165:                        e.g., 
        !           166: \begin{quote}\small\begin{verbatim}
        !           167: internet $ [email protected]
        !           168: \end{verbatim}\end{quote}
        !           169:                        or
        !           170: \begin{quote}\small\begin{verbatim}
        !           171: uucp $ uupsi!mrose
        !           172: \end{verbatim}\end{quote}
        !           173: 
        !           174: \item[userid:]
        !           175:                        which is the user's login name; e.g.,
        !           176: \begin{quote}\small\begin{verbatim}
        !           177: mrose
        !           178: \end{verbatim}\end{quote}
        !           179: 
        !           180: \item[userClass:]
        !           181:                        which describe's the user's classification; e.g.,
        !           182: \begin{quote}\small\begin{verbatim}
        !           183: staff
        !           184: \end{verbatim}\end{quote}
        !           185: \end{describe}
        !           186: The next optional group contains a few miscellaneous attributes:
        !           187: \begin{describe}
        !           188: \item[description:]
        !           189:                        which is a simple textual description;
        !           190:                        e.g.,
        !           191: \begin{quote}\small\begin{verbatim}
        !           192: Principal Implementor of the ISO Development Environment
        !           193: \end{verbatim}\end{quote}
        !           194: 
        !           195: \item[info:]
        !           196:                        which is additional information about the object;
        !           197:                        e.g.,
        !           198: \begin{quote}\small\begin{verbatim}
        !           199: It's nearly as good as BIND
        !           200: \end{verbatim}\end{quote}
        !           201: 
        !           202: \item[businessCategory:]
        !           203:                        which describes the person's business,
        !           204:                        e.g.,
        !           205: \begin{quote}\small\begin{verbatim}
        !           206: networking
        !           207: \end{verbatim}\end{quote}
        !           208: 
        !           209: \item[title:]
        !           210:                        which is the person's job title,
        !           211:                        e.g.,
        !           212: \begin{quote}\small\begin{verbatim}
        !           213: Senior Scientist
        !           214: \end{verbatim}\end{quote}
        !           215: 
        !           216: \item[userPassword:]
        !           217:                        which is a string containing the object's
        !           218:                        password in the Directory.  This is used,
        !           219:                        for example, when the user wants to update
        !           220:                        the entry.
        !           221:                        The password is kept in the clear; e.g.,
        !           222: \begin{quote}\small\begin{verbatim}
        !           223: secret
        !           224: \end{verbatim}\end{quote}
        !           225: 
        !           226: \item[mobileTelephoneNumber:]
        !           227:                        which is a string describing the user's mobile
        !           228:                        number (e.g., for a cellular phone).
        !           229: 
        !           230: \item[pagerTelephoneNumber:]
        !           231:                        which is a string describing the user's pager number.
        !           232: 
        !           233: \item[favouriteDrink:]
        !           234:                        which is a string describing the user's favorite drink.
        !           235: 
        !           236: \item[secretary:]
        !           237:                        which is the Distinguished Name of the user's
        !           238:                        administrative support.
        !           239: 
        !           240: \item[seeAlso:]
        !           241:                        which is a Distinguished Name pointing to another
        !           242:                        entry related to the user (perhaps in a different
        !           243:                        role).
        !           244: 
        !           245: \item[photo:]
        !           246:                        which is a facsimile bitmap of the user's face.
        !           247: \end{describe}
        !           248: The final optional group contains a few attributes about the person at home:
        !           249: \begin{describe}
        !           250: \item[homePostalAddress:]
        !           251:                        which describes how physical mail is addressed to the
        !           252:                        person's home.
        !           253:                        The syntax of this attribute's value is special:
        !           254:                        it consists of~1 to~6 fields, seperated by the
        !           255:                        ``\verb"$"''-sign, each field being from~1 to~30
        !           256:                        characters long; e.g.
        !           257: \begin{quote}\small\begin{verbatim}
        !           258: NYSERNet Inc. $ 165 Jordan Road $ Troy, NY 12180
        !           259: \end{verbatim}\end{quote}
        !           260: 
        !           261: \item[homePhone:]
        !           262:                which is a string describing the phone number of the object
        !           263:                using the international notation; e.g.,
        !           264: \begin{quote}\small\begin{verbatim}
        !           265: +1 518-283-8860
        !           266: \end{verbatim}\end{quote}
        !           267: \end{describe}

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