Return to q-sunint.tex CVS log

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

Annotation of 43BSDReno/contrib/isode-beta/doc/manual/q-sunint.tex, revision 1.1.1.1

1.1       root        1: % run this through LaTeX with the appropriate wrapper
                      2: 
                      3: \chapter {SUNINT}
                      4: 
                      5: \pgm{sunint} is a window interface developed at UCL.
                      6: It uses the feature of the SUNVIEW environment to give the user a set
                      7: of windows and menus with which they can query the directory.
                      8: As with WIDGET it is included only as an example of an X.500 interface, and how to
                      9: use the procedural interface, it has not been fully developed.
                     10: 
                     11: Like \verb"widget", \verb"sunint" only gives the users access to a subset of the X.500 protocol,
                     12: and as such is a read only interface.
                     13: 
                     14: \section {Using SUNINT}
                     15: The \verb"sunint" interface is invoked with the command \pgm{sunint}
                     16: 
                     17: The program automatically binds you to the local directory, unless a \tt -c\rm\ flag is given,
                     18: when the following argument is taken to be the address of the DSA 
                     19: to connect to.
                     20: 
                     21: Once started the user is given a window with two panels.
                     22: The upper panel displays the current position in the DIT, the lower 
                     23: displays the children.
                     24: 
                     25: \subsection {Menus}
                     26: Each item in the window has a menu associated with it.  By pressing the
                     27: {\em right} mouse button a menu of available options will be displayed.
                     28: If an option is `{\sl dimmed}' it means that that particular option is
                     29: unavailable.
                     30: 
                     31: When a menu item is selected (by moving the mouse over the menu item, and releasing
                     32: the mouse button) the appropriate action is taken.
                     33: 
                     34: \subsection {Moving around the DIT}
                     35: When you enter the program, you are automatically placed at the ROOT of the
                     36: DIT.
                     37: To move around the DIT, select the `{\em show children}' menu item for the 
                     38: ROOT entry.  This will display the Distinguished name and objectclass of 
                     39: all the children below the root in the lower panel.
                     40: If you now select the `{\em move to here}' menu item from one of the children,
                     41: The entry will be redisplayed in the top panel, from where it children can
                     42: be displayed.
                     43: 
                     44: \subsection {Reading the Attributes}
                     45: The menu item `{\em Show details}' will make the attribute of the entry
                     46: appear in a separate `pop-up' window.
                     47: 
                     48: This window can be removed by selection the {\em hide} option from the menu 
                     49: found by pressing the {\em right} button on one of the sides of the window.
                     50: 
                     51: \subsection {Searching}
                     52: Searching is selected by pressing the button labeled {\em search}, and
                     53: selecting the type of search required.
                     54: 
                     55: Selecting {\em general search} will display a window with room for text input
                     56: of a search filter.
                     57: The filter is specified in the same format as for DISH searches described in
                     58: section \ref{search}.
                     59: 
                     60: The other options are used to make simple searches.
                     61: A window is displayed with the attribute types you may want to search on
                     62: displayed.
                     63: For each type, you can enter the value want to search for, and select the
                     64: type of match required.
                     65: 
                     66: The result of the search will be displayed in a separate window.
                     67: 
                     68: \subsection{Quitting}
                     69: To quit, press the {\em quit} button with the {\em left} mouse button.
                     70: An automatic unbind will take place.
                     71: 
                     72: 

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