![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to attributes.tex CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / doc / whitepages / user|
Return to attributes.tex CVS log | Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / doc / whitepages / user |
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.