Annotation of 43BSDReno/contrib/isode-beta/doc/manual/imisc.tex, revision 1.1

1.1     ! root        1: % run this through LaTeX with the appropriate wrapper
        !             2: 
        !             3: \chapter      {The ISODE Little Services}\label{imisc}
        !             4: The {\em ISODE Little Services\/} are examples of a few simple
        !             5: applications written using {\em The ISO Development Environment}.
        !             6: The programs described herein should work on all systems on which the
        !             7: software runs.
        !             8: All of these programs have \unix/ manual entries.
        !             9: 
        !            10: The little services are based on the protocols of the same name found in
        !            11: the \dod/ TCP/IP protocol suite.
        !            12: There are several services:
        !            13: \begin{describe}
        !            14: \item[utcTime:] the universal time
        !            15: 
        !            16: \item[genTime:] the generalized time
        !            17: 
        !            18: \item[timeOfDay:]      the current date and time since the \unix/ epoch
        !            19: 
        !            20: \item[users:]  the users logged in on the system
        !            21: 
        !            22: \item[charGen:]        a character generation pattern
        !            23: 
        !            24: \item[qotd:]   a quote of the data
        !            25: 
        !            26: \item[finger:] ``fingers'' users logged in
        !            27: 
        !            28: \item[pwdGen:] six pseudo-randomly generated (allegedly mnemonic) passwords
        !            29: 
        !            30: \item[tellUser:] sends a message to a remote user
        !            31: 
        !            32: \item[ping:] ping test for performance measurement
        !            33: 
        !            34: \item[sink:] sink test for performance measurement
        !            35: 
        !            36: \item[echo:] echo test for performance measurement
        !            37: \end{describe}
        !            38: Only the {\em finger\/} service takes any arguments,
        !            39: the individuals on whom to report.
        !            40: 
        !            41: \section      {Implementation}
        !            42: If you have access to the source tree for this release,
        !            43: the directory \file{imisc/} contains the code for the responder and initiator.
        !            44: 
        !            45: \subsection    {The Initiator}
        !            46: The \man imisc(1c) program is the initiator which requests the little
        !            47: services.
        !            48: If invoked with arguments,
        !            49: it executes that exact operation and terminates.
        !            50: Otherwise, it enters interactive mode,
        !            51: prompting for each operation and argument until end-of-file is found.
        !            52: 
        !            53: In addition, the pseudo-operations \verb"help" and \verb"quit" do the
        !            54: obvious things.
        !            55: 
        !            56: \subsection    {The Responder}
        !            57: The \man imiscd(8c) program is the responder which implements the little
        !            58: services.
        !            59: 
        !            60: As shown in Figure~\ref{imisc:ros} on the following page,
        !            61: the ROS-based definition is very simple.
        !            62: \newpage
        !            63: \tagrindfile{grindimisc-1}{ROS definition of ISODE Little Services}{imisc:ros}

unix.superglobalmegacorp.com

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