rfc1373.txt

来自「RFC 的详细文档！」· 文本 代码 · 共 675 行 · 第 1/2 页

Network Working Group                                            T. Tignor
Request for Comments: 1373                                             ISI
                                                              October 1992


                             PORTABLE DUAs

Status of this Memo

   This memo provides information for the Internet community.  It does
   not specify an Internet standard.  Distribution of this memo is
   unlimited.

INTRODUCTION

   This document comes in two parts. The first part is for regular
   people who wish to set up their own DUAs (Directory User Interfaces)
   to access the Directory. It includes some brief notes on the
   operation of the DUAs and instructions for their creation and
   installation. The instructions are given in an easy-to-follow, step-
   by-step format. It is fully expected that the user will be able to
   perform the necessary operations as he reads through the instructions
   for the first time and have a working DUA when he finishes. The
   second part is for ISODE-maintainers wishing to provide portable DUAs
   to users. This part gives instructions in a similar but longer,
   step-by-step format. It is fully expected that the maintainer will be
   able to perform the necessary operations as he reads through the
   instructions for the first time and have a working DUA
   package/supporting service when he finishes.

   The document currently has four sub-parts for each larger part. The
   sub-parts detail the following DUAs: WHOIS, "de," dixie's "ud" and
   ISODE's "doog." It is intended that additional sub-parts will be
   added to the document as new, portable DUA packages are designed.

   Where pertinent, the document assumes ISODE 8.0 is being used.

   1.  Instructions for DUA-Users

   WHOIS

   A WHOIS interface to X.500 may be available on any ISODE-resident
   machine which also runs a DSA (Directory System Agent.) Check with
   your local, ISODE-maintainer. If the service is available, users can
   access the Directory with the following command:

        whois -h <hostname> <name in UFN format>




Tignor                                                          [Page 1]

RFC 1373             DSA Support for Portable DUAs          October 1992


   <hostname> indicates the name of the host machine offering the WHOIS
   interface, surrounded by quotes. <name in UFN format> refers to a
   special, user-friendly syntax developed by Steve Hardcastle-Kille.
   UFN format is a comma-separated list of DN component values.
   (Attribute types are omitted.) The criteria for identifying DN
   components in UFN is often less stringent than normal.  For example:

        @c=US@st=California@o=Information Sciences
        Institute@ou=HPCC@cn=Tom Tignor

   could be uniquely specified in UFN syntax as

        tignor,isi,ca,us

   So to find this entry through WHOIS, one would type:

        whois -h "gum.isi.edu" tignor,isi,ca,us

   See Steve Hardcastle-Kille's Work in Progress, "User Friendly Naming"
   for details.


   De

   Use of the "de" DUA is fully explained by the program's help section.
   New users should type "?" at the first prompt after installing and
   running the de executable.

   The de executable can be created and installed by the following
   simple steps:

        If you do not have a file called ".unknown_tailor" in your home
        directory, create it now. This file should contain the following
        single line:
             etcpath:   <fullpathname>/isode/etc/

        where <fullpathname> is the full path name of your $HOME
        directory.

        If you do not have a directory $HOME/isode/bin, where "$HOME" is
        your home directory, create it now.

        ftp the compressed tar file "de-portable.tar.Z" from your local,
        ISODE-resident machine and put it in your isode directory. If
        you cannot find this file locally, it is available by anonymous






Tignor                                                          [Page 2]

RFC 1373             DSA Support for Portable DUAs          October 1992


        ftp from "gum.isi.edu" in the "x500" directory.

        cd $HOME/isode

        uncompress < de-portable.tar.Z | tar xf -

        If your name is listed in the Directory, edit the de/detailor
        file and add a line reading:
             username: <yourDN>

        where <yourDN> indicates your Distinguished Name in the
        Directory.

        cp de/detailor de/etc/detailor

        Edit the CONFIG.make variables BINDIR, ETCDIR and SBINDIR to
        refer to your isode/bin, isode/etc and isode/etc directories,
        respectively.  (The isode/etc directory was created by the
        previous command.)

        ranlib libdsap.a

        ranlib libisode.a

        cd de

        ./make all

        ./make inst-all

   There is one error you may encounter during this procedure, following
   the "./make all" command:

        "Redeclaration of sprintf." in general.h

   If this error occurs, the following sub-procedure will fix the
   problem:

        Invoke your editor for the file ../h/general.h

        Search for the string "sprintf".

        Cut the line with the "#endif" string which follows the line
        reading:
             char *sprintf ();

        Paste the line under the line which reads "#endif". This second
        #endif line is exactly three lines below the current line.



Tignor                                                          [Page 3]

RFC 1373             DSA Support for Portable DUAs          October 1992


        Save the file and quit the editor.

   Type "./make all" again. It should now compile smoothly. Finish up by
   typing "./make inst-all".


   Dixie/Ud

   The "ud" DUA is designed for users doing most of their X.500 queries
   in one branch of the DIT (Directory Information Tree.) The DUA
   operates from a predefined "base," a position in the DIT one or more
   branches above the entries to be queried. The base is usually an
   organization name, such as:

        @c=US@st=California@o=Information Sciences Institute

   Ud starts with a preset base. (See below.) But this base can be
   changed with the "cb" command. "cb" takes the full DN of the new base
   as an argument. For example:

        cb @c=GB@o=University College London

   With a preset base, searching is easy. The user finds entries below
   the base with the "find" command. "find" takes the last component of
   the DN of the entry as its sole argument. The criteria for the
   argument is very loose. The partial matching performed by ud should
   return the desired data or a clarification request if the name is at
   all close to the real thing.

   For example, with a base "@c=US@st=California@o=Information Sciences
   Institute", the RDN

        ou=HPCC@cn=Tom Tignor

   could be found by entering

        find tignor

   at the ud prompt.

   Other commands in ud are briefly described by the program's help
   section. Interested users should type "?" at the first prompt, after
   installing and running the executable.

   "Ud" comes with the "dixie" package, a mini-environment designed
   specifically to support lightweight Directory access. Using ud
   requires that a dixie server is running along with a DSA on your
   local, ISODE-resident machine. Before retrieving the dixie package,



Tignor                                                          [Page 4]

RFC 1373             DSA Support for Portable DUAs          October 1992


   check with your local DSA manager to see that the dixie server is up
   and running.

   Once you're sure that everything is set up at the DSA-manager's end,
   the ud executable can be created and installed by the following
   simple steps:

        If you do not have a directory $HOME/isode/bin, where "$HOME" is
        your home directory, create it now.

        ftp (anonymously) the compressed tar file "dixie-<version
        #>.tar.Z", where <version #> is the number of the latest
        release, from "terminator.cc.umich.edu" and put it in your isode
        directory. The file is available in the "x500" directory on
        terminator.

        cd $HOME/isode

        uncompress < dixie-<version #>.tar.Z | tar xf -

   This creates the dixie environment. As a user interested in ud only,
   there are a number of things in the package that will be taking up
   space to no purpose. The following sequence of commands will get rid
   of them.

        cd dixie-<version #>

        rm -r dos

        rm -r macintosh

        rm -r server

        rm -r vms

        cd ..

   That done, we continue to bring ud to life.

        cd dixie-<version #>

        Edit the file "ud/ud.h". There are two constants for which you
        will need to supply new values: DEFAULT_BASE and DEFAULT_SERVER.
        DEFAULT_BASE identifies ud's "base" upon startup, as described
        above.  It takes a quoted DN as a value, e.g.,
        "@c=US@st=California@o=Information Sciences Institute".
        DEFAULT_SERVER identifies the machine which hosts the dixie
        server, i.e. your local, ISODE-resident machine. This constant



Tignor                                                          [Page 5]

RFC 1373             DSA Support for Portable DUAs          October 1992


        takes a quoted string as a value, e.g., "gum.isi.edu".

        Edit the file "Makefile". Set the value of the BINDIR variable
        to "<mypath>/isode/bin", where <mypath> is the full pathname of
        the user's home directory.

        make depend-ud

        make ud-only

        make inst-ud


   Doog

   The "doog" DUA retrieves information on entries supplied by the user
   in UFN format. UFN format refers to a special, user-friendly syntax
   developed by Steve Hardcastle-Kille. UFN format is a comma-separated
   list of DN component values. (Attribute types are omitted.) The
   criteria for identifying DN components in UFN is often less stringent
   than normal.  For example:

        @c=US@st=California@o=Information Sciences
        Institute@ou=HPCC@cn=Tom Tignor

   could be specified in UFN syntax (and doog) as

        tignor,isi,ca,us

   See Steve Hardcastle-Kille's Work in Progress, "User Friendly Naming"
   for details.

   Other commands in doog are briefly described by the program's help
   section. Interested users should type "?" at the first prompt, after
   installing and running the executable.

   The doog executable can be created and installed by the following
   simple steps:

        If you do not have a file called ".unknown_tailor" in your home
        directory, create it now. This file should contain the following
        single line:
             etcpath:   <fullpathname>/isode/etc/

        where <fullpathname> is the full path name of your $HOME
        directory.

        If you do not have a directory $HOME/isode/bin, where "$HOME" is



Tignor                                                          [Page 6]