Annotation of 43BSDReno/contrib/isode-beta/others/quipu/uips/sd/sd.1c, revision 1.1.1.1

1.1       root        1: .\"$Header: /f/osi/others/quipu/uips/sd/RCS/sd.1c,v 7.0 90/06/12 13:14:34 mrose Exp $"
                      2: .TH SD 1C "16 Jan 1909"
                      3: .SH NAME
                      4: sd \- Full-screen directory user agent.
                      5: .SH SYNOPSIS
                      6: .B sd
                      7: .SH DESCRIPTION
                      8: .PP
                      9: The \fIsd\fR program implements a simple window interface to
                     10: an X500 OSI directory.
                     11: It is derived from an original interface called "widget".
                     12: .PP
                     13: 
                     14: \fISd\fR runs on most cursor-addressable terminals, providing a full-screen
                     15: character-driven interface suitable for novice users.
                     16: It is based on the notion of "widgets" as characterized by the 
                     17: X-windows system and attempts to simulate button,
                     18: dialogue and text widgets.
                     19: Functions are invoked by pressing the initial letter of the 
                     20: function name displayed in the widget.
                     21: .PP
                     22: List and Search operations within the directory are conducted relative
                     23: to an area displayed in the \fISearch Area\fR widget.
                     24: An instance of this could be,
                     25: .sp
                     26: .in +.5i
                     27: .nf
                     28: \*(lqGB, Brunel University.\*(rq
                     29: .fi
                     30: .in -.5i
                     31: .sp
                     32: .PP
                     33: List returns a list of entries held below the 'Search Area'.
                     34: In the above case,
                     35: a call to list would return a list of departments in Brunel University.
                     36: .PP
                     37: A search is performed on the basis of
                     38: a search value 
                     39: (or attribute)
                     40: which describes some aspect of the
                     41: object 
                     42: (i.e. it's name,
                     43: location etc.)
                     44: and a type,
                     45: which associates the object being searched
                     46: for with one of a given set of types
                     47: (i.e. Person, Place, Organization, Department).
                     48: The search value is displayed in the \fISearch For\fR field
                     49: and it's type is shown in the \fIType\fR field.
                     50: Any search will return a list of objects that match
                     51: the given search value within the current search area.
                     52: To display information on or move to a listed object the list number
                     53: of that object must be entered.
                     54: .PP
                     55: An example of a simple search is shown below.
                     56: Here the target is the directory object for
                     57: \*(lqProfessor Polonius Plum\*(rq
                     58: of Brunel University.
                     59: The search is initiated with
                     60: the search area set to \*(lqGB, Brunel University.\*(rq,
                     61: a value \*(lqPlum\*(rq and type \*(lqPerson\*(rq,
                     62: with the directory then returning,
                     63: .sp
                     64: .in +.5i
                     65: .nf
                     66: 1 Computer Science, Polonius Plum
                     67: .br
                     68: 2 Law, Plumley Farquarson
                     69: .fi
                     70: .in -.5i
                     71: .sp
                     72: Subsequently entering '1' would then give,
                     73: .sp
                     74: .in +.5i
                     75: .nf
                     76: commonName      - Polonius Plum
                     77: .br
                     78: surname         - Plum
                     79: .br
                     80: userClass       - staff
                     81: .br
                     82: rfc822Mailbox  - [email protected]
                     83: .br
                     84: description    - "ruddy faced and gat toothed"
                     85: .fi
                     86: .in -.5i
                     87: .PP
                     88: A standard search strategy in \fIsd\fR,
                     89: and most other directory interfaces,
                     90: is to move to a suitable search area,
                     91: i.e. an \*(lqarea\*(rq in which the real world object is contained,
                     92: and to then search using an appropriate value and type.
                     93: .PP
                     94: In order to make \fIsd\fR simple to understand
                     95: there are no facilities for modifying entries.
                     96: .br
                     97: .SH "OPTIONS"
                     98: .TP 12
                     99: .BI \-c
                    100: Bind to named directory system agent.
                    101: Pod binds to your local dsa,
                    102: if not otherwise requested.
                    103: .TP
                    104: .SH "SEE ALSO"
                    105: dish(1c) widget(1c)
                    106: .br
                    107: \fIThe ISO Development Environment: User's Manual, Volume 5: QUIPU\fR
                    108: .br
                    109: ISO 9594:
                    110: \fIInformation Processing \-\- Open Systems Interconnection \-\-
                    111: The Directory\fR
                    112: .SH AUTHOR
                    113: [email protected]
                    114: .br
                    115: [email protected]

unix.superglobalmegacorp.com

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