![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to Xd.1c 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 / others / quipu / uips / xd|
Return to Xd.1c CVS log | Up to [CSRG BSD Unix] / 43BSDReno / contrib / isode-beta / others / quipu / uips / xd |
1.1 root 1: .\" $Header: /f/osi/others/quipu/uips/xd/RCS/Xd.1c,v 7.0 90/06/12 13:11:52 mrose Exp $
2: .TH XD 1C "2 Mar 1990"
3: .SH NAME
4: xd \- X windows directory user agent.
5: .SH SYNOPSIS
6: .B xd
7: .SH DESCRIPTION
8: .PP
9: The \fIxd\fR program implements a simple window interface to
10: an X500 OSI directory.
11: It is very distantly related to an interface called "widget".
12: .PP
13:
14: \fIXd\fR runs under X and provides a `push-button',
15: mouse-driven interface suitable for novice users.
16: Functions are invoked by clicking mouse button 1 (usually the
17: left most button) on the relevant button shape.
18: .PP
19: Searches within the directory are conducted relative
20: to an area displayed in the \fISearch Area\fR widget.
21: An instance of this could be,
22: .sp
23: .in +.5i
24: .nf
25: \*(lqGB, Brunel University.\*(rq
26: .fi
27: .in -.5i
28: .sp
29: A search is performed on the basis of
30: a search value
31: (or attribute)
32: which describes some aspect of the
33: object
34: (i.e. it's name,
35: location etc.)
36: and a type,
37: which associates the object being searched
38: for with one of a given set of types
39: (i.e. Person, Place, Organization, Department).
40: The search value is displayed in the \fISearch For\fR field
41: and it's type is shown in the \fIType\fR field.
42: Any search will return a list of objects that match
43: the given search value within the current search area.
44: To display information on or move to a listed object, point
45: at the object in the list area and click button 1.
46: .SH OPTIONS
47: .PP
48: The usual X command line parameters can
49: be passed to xd. Typically these might be:
50:
51: .TP 2i
52: -display display
53: This option specifies the name of the X server to
54: use.
55:
56: .TP 2i
57: -geometry geometry
58: This option specifies the initial size and location
59: of the window.
60:
61: .PP
62: These and other X options are described in X(1).
63: .bp
64: .PP
65: The following options relate to the quipu directory services.
66:
67: .TP 2i
68: -t tailor file
69:
70: .TP 2i
71: -c dsa name
72:
73: .TP 2i
74: -T oid table
75:
76: .TP 2i
77: -D directory
78:
79:
80: .SH EXAMPLES
81: .PP
82: An example of a simple search is shown below.
83: Here the target is the directory object for
84: \*(lqProfessor Polonius Plum\*(rq
85: of Brunel University.
86: The search is initiated with
87: the search area set to \*(lqGB, Brunel University.\*(rq,
88: a value \*(lqPlum\*(rq and type \*(lqPerson\*(rq,
89: with the directory then returning,
90: .sp
91: .in +.5i
92: .nf
93: Computer Science, Polonius Plum
94: .br
95: Law, Plumley Farquarson
96: .fi
97: .in -.5i
98: .sp
99: Subsequently clicking on P Plum would then give,
100: .sp
101: .in +.5i
102: .nf
103: commonName - Polonius Plum
104: .br
105: surname - Plum
106: .br
107: userClass - staff
108: .br
109: rfc822Mailbox - [email protected]
110: .br
111: description - "ruddy faced and gat toothed"
112: .fi
113: .in -.5i
114: .PP
115: A standard search strategy in \fIxd\fR,
116: and most other directory interfaces,
117: is to move to a suitable search area,
118: i.e. an \*(lqarea\*(rq in which the real world object is contained,
119: and to then search using an appropriate value and type.
120: .PP
121: The action of various objects in the xd interface is described below:
122:
123: .TP 2i
124: Quit
125: Exit Xd
126:
127: .TP 2i
128: Help
129: This provides a help
130: window which gives
131: help on the action
132: related to the current
133: position of the pointer
134:
135: .TP 2i
136: Search Area
137: Current position
138:
139: .TP 2i
140: Search For
141: Search string entry field
142:
143: .TP 2i
144: Type
145: Search data type selection
146:
147: .TP 2i
148: Read Area
149: The read area shows the result of
150: a read on an object. Error messages
151: and other progress messages are
152: also shown in this window.
153:
154: .TP 2i
155: Search
156: Begin search for data in the
157: Search For field
158:
159: .TP 2i
160: List
161: The List function returns all entries
162: immediately subordinate to the entry
163: specified as the current position. The
164: maximum size of the resulting list will
165: normally be limited to fifty, thus the
166: value of a call to List is limited if
167: searching for a specific directory entry.
168:
169: If the mouse button is pressed
170: to select an item from the list
171: window, that item becomes highlighted
172: and becomes the current
173: search area. A read of any
174: information held about that
175: item is also performed and the
176: result is shown in the Read
177: window.
178:
179:
180: .TP 2i
181: Look back
182: Lookback enables you to jump back to
183: the 10 places you most recently
184: selected from the list window.
185:
186: .TP 2i
187: Widen
188: Push button to put you back
189: one step. This allows you to
190: backtrack if you have gone to
191: a wrong location.
192:
193: .TP 2i
194: List Area
195: The result of a list or search action is
196: shown in the list window.
197:
198: .PP
199: In order to make \fIxd\fR simple to understand
200: there are no facilities for modifying entries.
201: .bp
202: .SH "SEE ALSO"
203: dish(1c) sd(1c) pod(1c) X(1)
204: .br
205: \fIThe ISO Development Environment: User's Manual, Volume 5: QUIPU\fR
206: .br
207: ISO 9594:
208: \fIInformation Processing \-\- Open Systems Interconnection \-\-
209: The Directory\fR
210: .SH AUTHOR
211: [email protected]
212: .br
213: [email protected]
214: .br
215: [email protected]
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.