Return to imisc.tex CVS log

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

Annotation of 43BSDReno/contrib/isode-beta/doc/manual/imisc.tex, revision 1.1.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}

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