home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / bsd_srcs / sys / tests / nfs / billboard / README < prev    next >
Encoding:
Text File  |  1990-01-05  |  4.7 KB  |  122 lines
  1. Product Description:
  2. -------------------
  3.         The BillBoard is an RPC service program which maintains
  4.         the information about testsuite completions.  There are 2 parts to the
  5.       program, the client and the server.  The client provides an interface
  6.     with which the user may update or view testsuite completions.  The
  7.     server maintains all data input by the client.
  8.     In order for a client to access or modify any data on the server
  9.     it must be supplied with an identifier.  The server uses this
  10.     identifier as a key for data access.  The identifiers will be assigned
  11.     by Sun and will be issued at Connectathon.  For the purpose of testing
  12.     the billboard programs on your machine, you use the identifiers
  13.     which you specify in the bb_data.company file.  An example data file
  14.     is provided for you and includes a description of the file.  A
  15.     password may be set for each identifier to provide some measure of
  16.     security.
  17.  
  18.     There are 2 versions of the program:  
  19.     billboard and bb are the client and server program respectively for 
  20.              the NFS testsuites. 
  21.  
  22.     xbillboard and xbb are the client and server program respectively for 
  23.                the X testsuites. 
  24.  
  25.  
  26. Usage:
  27. -----
  28.     Client:
  29.     ------
  30.     1) Set the environment variable BB_SERVER to the hostname of the
  31.        machine running the billboard server,
  32.        eg. If we are using the billboard programs for the NFS testsuites 
  33.            and the host running bb server is "holy_cow", then you may
  34.            do this
  35.             %setenv BB_SERVER holy_cow
  36.  
  37.     2) Run the client program:
  38.        for the NFS testsuites:
  39.          billboard [-s|-u client_identifier server_identifier]
  40.                      [-a|-b client_identifier]
  41.                      [-c|-d server_identifier]
  42.               [-p identifier]
  43.  
  44.        for the X testsuites:
  45.          xbillboard [-s|-u client_identifier server_identifier]
  46.                       [-a|-b client_identifier]
  47.                       [-c|-d server_identifier]
  48.                [-p identifier]
  49.  
  50.        options:
  51.          -s client_identifier server_identifier>
  52.                 is to set test between client_identifier and 
  53.                 server_identifier as successfully tested
  54.          -u client_identifier server_identifier
  55.                 to set test between client_identifier and 
  56.                 server_identifier as NOT successfully tested
  57.          -a client_identifier
  58.              to list server implementations that are successfully
  59.              tested against client client_identifier
  60.          -b client_identifier
  61.              to list server implementations that are NOT 
  62.             successfully tested against client client_identifier
  63.          -c server_identifier
  64.              to list client implementations that are successfully
  65.              tested against server server_identifier
  66.          -d server_identifier
  67.              to list client implementations that are NOT 
  68.              successfully tested against server server_identifier
  69.          -p identifier
  70.              to change the password of the identifier implementation.
  71.                There is a password for each implementation.
  72.             
  73.          where 
  74.                 client_identifier and server_identifier are
  75.                    identifiers of the client and server implementation
  76.                    respectively.
  77.  
  78.         If no option is specified, the program is in interactive mode.
  79.          Whereby the user is presented with a list of options 
  80.         (same as the features described above) to choose from.  
  81.         User will be prompted for any additional data.
  82.  
  83.         Server:  
  84.     -------
  85.     1) In order to use the billboard server you must edit the file
  86.            named bb_data.company.  This file contains entries for each 
  87.        implementation to be tested.  The file itself contains information 
  88.        about it's structure and syntax.  
  89.  
  90.     2) Start the billboard server from the same directory where the 
  91.        bb_data.company file exists.  The name of the executable is bb for
  92.        NFS testsuite server, and xbb for X testsuite server.
  93.  
  94.  
  95. Porting    Note:
  96. ------------
  97. The current implementation runs on all Sun platforms.
  98. You will need to port the client programs, (i.e. billboard if you are testing 
  99. NFS at Connectathon, and xbillboard if you are testing X).
  100. Though, you do need to port the servers to your machine to test the client 
  101. programs, both servers will be provided and run on a Sun machine at 
  102. Connectathon.
  103.  
  104. All sources are in the src/ directory.
  105. Sources for client program uses "billboard" as prefix, and  server use
  106. "bb" as prefix.  The Makefile contains compilation instructions for both
  107. client and servers.  protocol.x is the the protocol to be used with rpcgen.
  108.  
  109. To compile:
  110.     %cd src
  111.     %make        makes client and server executables, OR
  112.     %make debug    makes with -g option
  113.  
  114. What can be modified:
  115. --------------------
  116. 1) At Connectathon the billboard servers will be run ONLY on a Sun machine,
  117.    hence, only the client program may be modified to your liking.
  118.  
  119. 2) The password encryption algorithm can be modified in _bb_get_passwd() 
  120.    (billboard.c).  The algorithm used is UNIX DES with a fixed salt key, you
  121.    are welcome to implement your own.
  122.