README
1Portions created by SGI are Copyright (C) 2000 Silicon Graphics, Inc.
2All Rights Reserved.
3
4
5This directory contains three example programs.
6
7
8---------------------------------------------------------------------------
9
10PROGRAM
11
12 lookupdns
13
14FILES
15
16 lookupdns.c
17 res.c
18
19USAGE
20
21 lookupdns <hostname1> [<hostname2>] ...
22
23DESCRIPTION
24
25 This program performs asynchronous DNS host name resolution and reports
26 IP address for each <hostname> specified as a command line argument.
27 One ST thread is created for each host name. All threads do host name
28 resolution concurrently.
29
30
31---------------------------------------------------------------------------
32
33PROGRAM
34
35 proxy
36
37FILES
38
39 proxy.c
40
41USAGE
42
43 proxy -l <local_addr> -r <remote_addr> [-p <num_processes>] [-S]
44
45 -l <local_addr> bind to local address specified as [<host>]:<port>
46 -r <remote_addr> connect to remote address specified as <host>:<port>
47 -p <num_processes> create specified number of processes
48 -S serialize accept() calls from different processes
49 on the same listening socket (if needed).
50
51DESCRIPTION
52
53 This program acts as a generic gateway. It listens for connections to a
54 local address. Upon accepting a client connection, it connects to the
55 specified remote address and then just pumps the data through without any
56 modification.
57
58
59---------------------------------------------------------------------------
60
61PROGRAM
62
63 server
64
65FILES
66
67 server.c
68 error.c
69
70USAGE
71
72 server -l <log_directory> [<options>]
73
74 -l <log_directory> open all log files in specified directory.
75
76 Possible options:
77
78 -b <host>:<port> bind to specified address (multiple addresses
79 are permitted)
80 -p <num_processes> create specified number of processes
81 -t <min_thr>:<max_thr> specify thread limits per listening socket
82 across all processes
83 -u <user> change server's user id to specified value
84 -q <backlog> set max length of pending connections queue
85 -a enable access logging
86 -i run in interactive mode (useful for debugging)
87 -S serialize accept() calls from different processes
88 on the same listening socket (if needed).
89
90DESCRIPTION
91
92 This program is a general server example. It accepts a client connection
93 and outputs a short HTML page. It can be easily adapted to provide
94 other services.
95
96
97---------------------------------------------------------------------------
98
99