common/docs/libutilPVM.1

   1 .\"
   2 .\" $Log: libutilPVM.1,v $
   3 .\" Revision 1.1  1994/02/25 11:16:01  markc
   4 .\" Initial revision
   5 .\"
   6 .\"
   7 .TH LIBUTILPVM 1L PARADYN "\\n(mo/\\n(dy/19\\n(yr"
   8 .SH NAME
   9 libutilPVM \- Support Library
  10 .SH DESCRIPTION
  11 .PP
  12 This library provides utility functions.  It provides a list class, a hash table class, and functions to support client-server communications using XDR/pvm/threads.
  13 .SH "LIST CLASS SYNOPSIS"
  14 .B template <class Type> class List {
  15 .br
  16 .B      public:
  17 .br
  18 .B      List();
  19 .br
  20 .B      int  empty();
  21 .br
  22 .B      friend ostream &operator<<(ostream&, List<Type>&);
  23 .br
  24 .B      void print();
  25 .br
  26 .B      void add(Type data, void *key);
  27 .br
  28 .B      void add(Type data);
  29 .br
  30 .B      Boolean addUnique(Type data);
  31 .br
  32 .B      Boolean addUnique(Type data, void *key);
  33 .br
  34 .B      Type find(void *key);
  35 .br
  36 .B      Boolean remove(void *key);
  37 .br
  38 .B      int count();
  39 .br
  40 .B      Type operator *();
  41 .br
  42 .B      void operator +=(List<Type> mergee);
  43 .br
  44 .B      Type operator ++();
  45 .br
  46 .B      void map (void (*map_function)(const Type item));
  47 .br
  48 .B      void setCurrent();
  49 .br
  50 .B      const Type getCurrent();
  51 .br
  52 .B      const Type next();
  53 .br
  54 .B      void advanceCurrent();
  55 .br
  56 .B      protected:
  57 .br
  58 .B      ListItem<Type>  *head;
  59 .br
  60 .B      ListItem<Type>  *current;
  61 .br
  62 };
  63 .br
  64 .SH "HASH TABLE CLASS SYNOPSIS"
  65 .PP
  66 .B template <class Type> class HTable {
  67 .br
  68 .B    public:
  69 .br
  70 .B      friend ostream &operator<<(ostream&, HTable<Type>&);
  71 .br
  72 .B      void print();
  73 .br
  74 .B      HTable(Type data);
  75 .br
  76 .B      void add(Type data, void *key);
  77 .br
  78 .B      HTable();
  79 .br
  80 .B      Boolean addUnique(Type data, void *key);
  81 .br
  82 .B      Type find(void *key);
  83 .br
  84 .B      Boolean remove(void *key);
  85 .br
  86 .B      Type operator =(HTable<Type> arg);
  87 .br
  88 .B      Type operator *();
  89 .br
  90 .B      Type operator ++();
  91 .br
  92 .B      int count();
  93 .br
  94 .B      private:
  95 .br
  96 .B      List<Type> **table;
  97 .br
  98 .B      List<Type> currList;
  99 .br
 100 .B      int currHid;
 101 .br
 102 .B      int tableSize;
 103 .br
 104 };
 105 .br
 106 .SH "LIBRARY SYNOPSIS"
 107 .TP 8
 108 .B int RPCprocessCreate (pid, host, User, command,
 109 .B       args)
 110 .br
 111 .B int *pid;
 112 .br
 113 .B char *host;
 114 .br
 115 .B char *User;
 116 .br
 117 .B char *command;
 118 .br
 119 .B char **args;
 120 .TP 8
 121 .B int RPC_readReady (fd)
 122 .br
 123 .B int fd;
 124 .TP 8
 125 .B int RPC_setup_socket (socket_fd, family, type)
 126 .br
 127 .B int *socket_fd;
 128 .br
 129 .B int family;
 130 .br
 131 .B int type;
 132 .TP 8
 133 .B char **RPC_make_arg_list (program, family, type,
 134 .B                           port, flag)
 135 .br
 136 .B char *program;
 137 .br
 138 .B int family;
 139 .br
 140 .B int type;
 141 .br
 142 .B int port;
 143 .br
 144 .B int flag;
 145 .TP 8
 146 .B int RPC_undo_arg_list (argc, arg_list, machine,
 147 .B                         family, type, socket, flag)
 148 .br
 149 .B int argc;
 150 .br
 151 .B char **arg_list;
 152 .br
 153 .B char **machine;
 154 .br
 155 .B int *family;
 156 .br
 157 .B int *type;
 158 .br
 159 .B int *socket;
 160 .br
 161 .B int *flag;
 162 .TP 8
 163 .B int RPC_getConnect (fd)
 164 .br
 165 .B int fd;
 166
 167 .SH "LIST CLASS DESCRIPTION"
 168 .PP
 169 .SH "HASH TABLE DESCRIPTION"
 170 .PP
 171 .SH "LIBRARY DESCRIPTION"
 172 .PP
 173 .B int RPCprocessCreate (pid, host, User, command,
 174 .B       args)
 175 .br
 176 .B int *pid;
 177 .br
 178 .B char *host;
 179 .br
 180 .B char *User;
 181 .br
 182 .B char *command;
 183 .br
 184 .B char **args;
 185 .br
 186 stdout will be closed for the exec'd program.  The pid is returned in pid.
 187 Host is the name of the host to start the program on.  Command is the name
 188 of the command to exec.  If args is non-null, it will be used as an argument
 189 for the exec.  Thus, command should be the first entry in args.  If args is
 190 null, command is passed as the argument list.
 191 .TP 8
 192 .B int RPC_readReady (fd)
 193 .br
 194 .B int fd;
 195 .TP 8
 196 .B int RPC_setup_socket (socket_fd, family, type)
 197 .br
 198 .B int *socket_fd;
 199 .br
 200 .B int family;
 201 .br
 202 .B int type;
 203 .TP 8
 204 .B char **RPC_make_arg_list (program, family, type,
 205 .B                           port, flag)
 206 .br
 207 .B char *program;
 208 .br
 209 .B int family;
 210 .br
 211 .B int type;
 212 .br
 213 .B int port;
 214 .br
 215 .B int flag;
 216 .TP 8
 217 .B int RPC_undo_arg_list (argc, arg_list, machine,
 218 .B                         family, type, socket, flag)
 219 .br
 220 .B int argc;
 221 .br
 222 .B char **arg_list;
 223 .br
 224 .B char **machine;
 225 .br
 226 .B int *family;
 227 .br
 228 .B int *type;
 229 .br
 230 .B int *socket;
 231 .br
 232 .B int *flag;
 233 .TP 8
 234 .B int RPC_getConnect (fd)
 235 .br
 236 .B int fd;
 237
 238 .SH "SEE ALSO"
 239 Paradyn(1).
 240 .SH COPYRIGHT
 241 Copyright 1994, The Paradyn Software Team.
 242 .SH AUTHOR
 243 Mark Callaghan     (markc@cs.wisc.edu)
 244
 245
 246