1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
|
/* $Id: http-rman.c,v 1.2.10.1 2000/10/18 13:02:19 alanh Exp $
*
* Name:
* http-rman.c -- a rudimentary man-page HTTP server
*
* Description:
* This is a minimal HTTP server using RosettaMan by T.A. Phelps
* (phelps@ACM.org) to produce hypertext renditions
* of man-pages on the fly.
*
* This server processes URLs with the following syntax:
*
* [/man] ?<command> [ ?<section> ]
*
* For URLs matching this format, it pipes the output of
* man <section> <command> through rman and sends it to
* the HTTP client. For other URLs, it returns the document
* given as argv[1] (using cat(1). The leading /man is
* optional, but is strongly recommended.
*
* This server is shipped as two files, the http-rman.c
* sources and the http-rman.html sample frontpage. I have
* not included a Makefile; you can write your own or just
* type [g]cc -o http-rman http-rman.c
*
* What do I need to run this:
* If you don't have it, pick up RosettaMan by anonymous ftp
* from ftp.cs.berkeley.edu: /ucb/people/phelps/tcl/rman.tar.Z
*
* You'll also need an HTTP client such as NCSA Mosaic to talk
* to this server. Mosaic is available by anonymous FTP from
* ftp://ftp.ncsa.uiuc.edu/Mosaic
*
* Both RosettaMan (rman) and Mosaic are available from many
* other sites. Try Archie, or check your local or national net
* archive.
*
* How do I get it running:
* First, compile the server (see above), and install it
* somewhere.
*
* The server runs under inetd(8). Add a service to
* /etc/services, say:
*
* http-rman 4080/tcp
*
* If you're not about to install another HTTP server on your
* machine, you may use the default HTTP port, 80, instead.
*
* Then add an entry to /etc/inetd.conf, such as (on a single line):
*
* http-rman stream tcp nowait root /usr/local/bin/http-rman
* http-rman /usr/local/lib/rman/http-rman.html
*
* Change /usr/local/bin and /usr/local/lib/rman to where you
* installed the two files. In addition, you may wish to run
* the server as something other than root...
*
* Restart inetd(8) (use kill -HUP or kill it and start it again)
* and try the following:
*
* $ Mosaic http://localhost:4080
*
* If you don't have Mosaic, try the following instead:
*
* $ telnet localhost 4080
* Trying 127.0.0.1...
* Connected to localhost.
* Escape character is '^]'.
* GET /man?ls <return>
* <return>
* HTTP/1.0 200 OK
* ...
*
* Portability:
* You'll need an ANSI compiler (or an editor and some patience).
* As it stands right now, this code has been successfully
* compiled on OSF/1 AXP using cc, and on SunOS 4.1 using gcc.
* Might need some tuning for other platforms.
*
* Legal Issues:
* Check the external visibility of the http-rman service
* you choose. This server gives a user access to ALL man-
* pages on your machine. You may have installed copyrighted
* software (your operating system, for example) with
* man-pages that you are NOT allowed to make visible for
* anyone out there...
*
* History:
* 94-04-30 fl: created
* 94-05-13 fl: stripped away everything but rman support
*
* Copyright (c) Fredrik Lundh 1994 (fredrik_lundh@ivab.se)
* All rights reserved.
*/
#include <stdio.h> /* printf(), fflush(stdio) etc */
#include <string.h> /* strrchr(), strcmp() etc */
static int
http_error(int error)
{
char *p;
switch (error) {
case 400:
p = "Bad Request";
break;
case 404:
p = "Not Found";
break;
default:
p = "Error";
}
printf("HTTP/1.0 %d %s\r\n", error, p);
printf("MIME-version: 1.0\r\n");
printf("Content-Type: text/html\r\n\r\n");
printf("<head><title>%d %s</title></head>\r\n", error, p);
printf("<body><h1>%d %s</h1></body>\r\n", error, p);
return 0;
}
static int
http_rman(char *url)
{
char *pName;
char *pSection;
char buf[200];
/* parse URL: should be /man?command[?section] */
pSection = strrchr(url, '?');
if (!pSection) {
return -1;
}
pName = pSection-1;
*pSection++ = '\0';
pName = strrchr(url, '?');
if (!pName) {
pName = pSection;
pSection = "";
}
else
pName++;
sprintf(buf, "man %s %s | rman -r \"man?%%s?%%s\" -n %s -f html",
pSection, pName, pName);
return system(buf);
}
int
main(int ac, char **av)
{
char buf[200];
char url[200];
int status;
char *sFrontpage = "/usr/local/lib/rman/http-rman.html";
/* check arguments */
if (ac > 1)
sFrontpage = av[1];
/* just read in one line from stdin and make sure it is a GET
command */
if (gets(buf)) {
/* read rest of command (just for the sake of it) */
while (gets(url) && url[0] != '\r')
;
/* command should be GET <url> [HTTP/1.0] */
if (sscanf(buf, "GET %s", url) == 1) {
status = http_rman(url);
if (status < 0) {
sprintf(buf, "cat %s", sFrontpage);
if (system(buf) == 0)
status = 0;
}
if (status < 0)
http_error(404);
} else
http_error(400);
}
fflush(stdout);
exit(0);
}
|
