Project

General

Profile

Download (46.9 KB) Statistics
| Branch: | Revision:
1
%!PS-Adobe-3.0
2
%%Creator: groff version 1.20.1
3
%%CreationDate: Tue Dec  3 00:47:18 2013
4
%%DocumentNeededResources: font Times-Roman
5
%%+ font Times-Bold
6
%%+ font Times-Italic
7
%%+ font Times-BoldItalic
8
%%DocumentSuppliedResources: procset grops 1.20 1
9
%%Pages: 7
10
%%PageOrder: Ascend
11
%%DocumentMedia: Default 595 842 0 () ()
12
%%Orientation: Portrait
13
%%EndComments
14
%%BeginDefaults
15
%%PageMedia: Default
16
%%EndDefaults
17
%%BeginProlog
18
%%BeginResource: procset grops 1.20 1
19
%!PS-Adobe-3.0 Resource-ProcSet
20
/setpacking where{
21
pop
22
currentpacking
23
true setpacking
24
}if
25
/grops 120 dict dup begin
26
/SC 32 def
27
/A/show load def
28
/B{0 SC 3 -1 roll widthshow}bind def
29
/C{0 exch ashow}bind def
30
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
31
/E{0 rmoveto show}bind def
32
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
33
/G{0 rmoveto 0 exch ashow}bind def
34
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
35
/I{0 exch rmoveto show}bind def
36
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
37
/K{0 exch rmoveto 0 exch ashow}bind def
38
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
39
/M{rmoveto show}bind def
40
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
41
/O{rmoveto 0 exch ashow}bind def
42
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
43
/Q{moveto show}bind def
44
/R{moveto 0 SC 3 -1 roll widthshow}bind def
45
/S{moveto 0 exch ashow}bind def
46
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
47
/SF{
48
findfont exch
49
[exch dup 0 exch 0 exch neg 0 0]makefont
50
dup setfont
51
[exch/setfont cvx]cvx bind def
52
}bind def
53
/MF{
54
findfont
55
[5 2 roll
56
0 3 1 roll
57
neg 0 0]makefont
58
dup setfont
59
[exch/setfont cvx]cvx bind def
60
}bind def
61
/level0 0 def
62
/RES 0 def
63
/PL 0 def
64
/LS 0 def
65
/MANUAL{
66
statusdict begin/manualfeed true store end
67
}bind def
68
/PLG{
69
gsave newpath clippath pathbbox grestore
70
exch pop add exch pop
71
}bind def
72
/BP{
73
/level0 save def
74
1 setlinecap
75
1 setlinejoin
76
DEFS/BPhook known{DEFS begin BPhook end}if
77
72 RES div dup scale
78
LS{
79
90 rotate
80
}{
81
0 PL translate
82
}ifelse
83
1 -1 scale
84
}bind def
85
/EP{
86
level0 restore
87
showpage
88
}def
89
/DA{
90
newpath arcn stroke
91
}bind def
92
/SN{
93
transform
94
.25 sub exch .25 sub exch
95
round .25 add exch round .25 add exch
96
itransform
97
}bind def
98
/DL{
99
SN
100
moveto
101
SN
102
lineto stroke
103
}bind def
104
/DC{
105
newpath 0 360 arc closepath
106
}bind def
107
/TM matrix def
108
/DE{
109
TM currentmatrix pop
110
translate scale newpath 0 0 .5 0 360 arc closepath
111
TM setmatrix
112
}bind def
113
/RC/rcurveto load def
114
/RL/rlineto load def
115
/ST/stroke load def
116
/MT/moveto load def
117
/CL/closepath load def
118
/Fr{
119
setrgbcolor fill
120
}bind def
121
/setcmykcolor where{
122
pop
123
/Fk{
124
setcmykcolor fill
125
}bind def
126
}if
127
/Fg{
128
setgray fill
129
}bind def
130
/FL/fill load def
131
/LW/setlinewidth load def
132
/Cr/setrgbcolor load def
133
/setcmykcolor where{
134
pop
135
/Ck/setcmykcolor load def
136
}if
137
/Cg/setgray load def
138
/RE{
139
findfont
140
dup maxlength 1 index/FontName known not{1 add}if dict begin
141
{
142
1 index/FID ne
143
2 index/UniqueID ne
144
and
145
{def}{pop pop}ifelse
146
}forall
147
/Encoding exch def
148
dup/FontName exch def
149
currentdict end definefont pop
150
}bind def
151
/DEFS 0 def
152
/EBEGIN{
153
moveto
154
DEFS begin
155
}bind def
156
/EEND/end load def
157
/CNT 0 def
158
/level1 0 def
159
/PBEGIN{
160
/level1 save def
161
translate
162
div 3 1 roll div exch scale
163
neg exch neg exch translate
164
0 setgray
165
0 setlinecap
166
1 setlinewidth
167
0 setlinejoin
168
10 setmiterlimit
169
[]0 setdash
170
/setstrokeadjust where{
171
pop
172
false setstrokeadjust
173
}if
174
/setoverprint where{
175
pop
176
false setoverprint
177
}if
178
newpath
179
/CNT countdictstack def
180
userdict begin
181
/showpage{}def
182
/setpagedevice{}def
183
mark
184
}bind def
185
/PEND{
186
cleartomark
187
countdictstack CNT sub{end}repeat
188
level1 restore
189
}bind def
190
end def
191
/setpacking where{
192
pop
193
setpacking
194
}if
195
%%EndResource
196
%%EndProlog
197
%%BeginSetup
198
%%BeginFeature: *PageSize Default
199
<< /PageSize [ 595 842 ] /ImagingBBox null >> setpagedevice
200
%%EndFeature
201
%%IncludeResource: font Times-Roman
202
%%IncludeResource: font Times-Bold
203
%%IncludeResource: font Times-Italic
204
%%IncludeResource: font Times-BoldItalic
205
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
206
def/PL PLG def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
207
/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef
208
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
209
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
210
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
211
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
212
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
213
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
214
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
215
/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
216
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
217
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
218
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
219
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
220
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
221
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
222
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
223
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
224
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
225
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
226
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
227
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
228
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
229
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
230
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
231
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
232
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
233
/Times-BoldItalic@0 ENC0/Times-BoldItalic RE/Times-Italic@0 ENC0
234
/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE/Times-Roman@0 ENC0
235
/Times-Roman RE
236
%%EndSetup
237
%%Page: 1 1
238
%%BeginPageSetup
239
BP
240
%%EndPageSetup
241
/F0 10/Times-Roman@0 SF(SHELLIN)72 48 Q(ABO)-.35 E 289.26
242
(XD\(1\) SHELLIN)-.4 F(ABO)-.35 E(XD\(1\))-.4 E/F1 10.95/Times-Bold@0 SF
243
-.219(NA)72 84 S(ME).219 E F0
244
(shellinaboxd \255 publish command line shell through AJ)108 96 Q
245
(AX interf)-.6 E(ace)-.1 E F1(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF
246
(shellinaboxd)108 124.8 Q F0([)144 136.8 Q F2(-b)2.5 E F0(|)2.5 E F2
247
(--backgr)12.896 E(ound)-.18 E F0([)A F2(=)A/F3 10/Times-Italic@0 SF
248
(pid\214le)A F0 5.396 2.5(]] [)D F2(-c)A F0(|)2.5 E F2(--cert=)12.896 E
249
F3(certdir)A F0 12.896(][)2.5 G F2(--cert-fd=)-10.396 E F3(fd)A F0
250
12.896(][)2.5 G F2(--css=)-10.396 E F3(\214lename)A F0(])2.5 E([)144
251
148.8 Q F2(--cgi)2.5 E F0([)A F2(=)A F3(portr)A(ang)-.15 E(e)-.1 E F0
252
-3.759 2.5(]] [)D F2(-d)A F0(|)2.5 E F2(--deb)3.741 E(ug)-.2 E F0 3.741
253
(][)2.5 G F2(-f)-1.241 E F0(|)2.5 E F2(--static-\214le=)3.741 E F3(url)A
254
F0(:)A F3(\214le)A F0 3.741(][)2.5 G F2(-g)-1.241 E F0(|)2.5 E F2(--gr)
255
3.741 E(oup=)-.18 E F3(gid)A F0 3.742(][)2.5 G F2(-h)-1.242 E F0(|)2.5 E
256
F2(--help)3.742 E F0(])2.5 E([)144 160.8 Q F2(--linkify)2.5 E F0(=[)A F2
257
(none)A F0(|)A F2(normal)A F0(|)A F2(aggr)A(essi)-.18 E -.1(ve)-.1 G F0
258
2.795 2.5(]] [).1 H F2(--localhost-only)A F0 10.295(][)2.5 G F2
259
(--no-beep)-7.795 E F0 10.295(][)2.5 G F2(-n)-7.795 E F0(|)2.5 E F2
260
(--numeric)10.295 E F0(])2.5 E([)144 172.8 Q F2(--pid\214le=)2.5 E F3
261
(pid\214le)A F0 3.057(][)2.5 G F2(-p)-.557 E F0(|)2.5 E F2(--port=)3.057
262
E F3(port)A F0 3.057(][)2.5 G F2(-s)-.557 E F0(|)2.5 E F2(--ser)3.057 E
263
(vice=)-.1 E F3(service)A F0 3.057(][)2.5 G F2(-t)-.557 E F0(|)2.5 E F2
264
(--disable-ssl)3.057 E F0 3.058(][)2.5 G F2(--disable-ssl-)-.558 E(menu)
265
144 184.8 Q F0 2.5(][)2.5 G F2(-q)A F0(|)2.5 E F2(--quiet)2.5 E F0 2.5
266
(][)2.5 G F2(-u)A F0(|)2.5 E F2(--user=)2.5 E F3(uid)A F0 2.5(][)2.5 G
267
F2(--user)A(-css=)-.37 E F3(styles)A F0 2.5(][)2.5 G F2(-v)A F0(|)2.5 E
268
F2(--v)2.5 E(erbose)-.1 E F0 2.5(][)2.5 G F2(--v)A(ersion)-.1 E F0(])2.5
269
E F1(DESCRIPTION)72 201.6 Q F0(The)108 213.6 Q F2(shellinaboxd)2.889 E
270
F0 .389(daemon implements a webserv)2.889 F .389
271
(er that listens on the speci\214ed)-.15 F F3(port)2.888 E F0 5.388(.T)
272
.68 G .388(he web serv)-5.388 F .388(er pub-)-.15 F 1.444
273
(lishes one or more)108 225.6 R F3(services)4.284 E F0 1.444
274
(that will be displayed in a VT100 emulator implemented as an AJ)4.214 F
275
1.445(AX web)-.6 F(application. By def)108 237.6 Q
276
(ault, the port is 4200 and the def)-.1 E(ault service URL is)-.1 E F3
277
(http://localhost:4200/)2.5 E F0(.)1.58 E .64(If no particular)108 254.4
278
R F3(service)3.48 E F0 -.1(wa)3.32 G 3.14(sr).1 G .64
279
(equested, the serv)-3.14 F .64(er launches)-.15 F F2(/bin/login)3.14 E
280
F0 .64(querying the user for their username)3.14 F(and passw)108 266.4 Q
281
(ord. It then starts the user')-.1 E 2.5(sd)-.55 G(ef)-2.5 E
282
(ault login shell.)-.1 E(An)108 283.2 Q 4.159(ym)-.15 G 1.659(odern Ja)
283
-4.159 F -.25(va)-.2 G 1.659(Script and CSS enabled bro).25 F 1.659
284
(wser will be able to access the published)-.25 F F3(service)4.5 E F0
285
(without)4.34 E(requiring additional plugins.)108 295.2 Q F1(OPTIONS)72
286
312 Q F0(The follo)108 324 Q
287
(wing command line parameters control the operation of the daemon:)-.25
288
E F2(-b)108 340.8 Q F0(|)2.5 E F2(--backgr)2.5 E(ound)-.18 E F0([)A F2
289
(=)A F3(pid\214le)A F0(])A(Launch)125.64 352.8 Q F2(shellinaboxd)2.5 E
290
F0(as a background daemon process. Optionally)2.5 E 2.5(,w)-.65 G
291
(rite the process id to)-2.5 E F3(pid\214le)2.5 E F0(.).18 E F2(-c)108
292
369.6 Q F0(|)2.5 E F2(--cert=)2.5 E F3(certdir)A F0 .309(If b)125.64
293
381.6 R .308(uilt with SSL/TLS support enabled, the daemon will look in)
294
-.2 F F3(certdir)3.008 E F0 .308(for an)3.538 F 2.808(yc)-.15 G .308
295
(erti\214cates. If unspeci-)-2.808 F(\214ed, this def)125.64 393.6 Q
296
(aults to the current w)-.1 E(orking directory)-.1 E(.)-.65 E .822
297
(If the bro)125.64 417.6 R .822(wser ne)-.25 F .822(gotiated a)-.15 F F2
298
(Ser)3.322 E -.1(ve)-.1 G 3.322(rN).1 G .822(ame Identi\214cation)-3.322
299
F F0 .822(the daemon will look for a matching)3.322 F F3(certi\214-)
300
3.522 E(cate-)125.64 429.6 Q/F4 10/Times-BoldItalic@0 SF(SER)A(VERN)-.18
301
E(AME)-.3 E F3(.pem)A F0 .194(\214le. This allo)3.014 F .194
302
(ws for virtual hosting of multiple serv)-.25 F .193
303
(er names on the same IP)-.15 F(address and port.)125.64 441.6 Q(If no)
304
125.64 465.6 Q F2(SNI)2.5 E F0(handshak)2.5 E 2.5(et)-.1 G
305
(ook place, it f)-2.5 E(alls back on using the certi\214cate in the)-.1
306
E F3(certi\214cate)2.7 E(.pem)-.15 E F0(\214le.)2.82 E .353
307
(The administrator should mak)125.64 489.6 R 2.853(es)-.1 G .353(ure th\
308
at there are matching certi\214cates for each of the virtual hosts on)
309
-2.853 F(this serv)125.64 501.6 Q(er)-.15 E 2.5(,a)-.4 G
310
(nd that there is a generic)-2.5 E F3(certi\214cate)2.7 E(.pem)-.15 E F0
311
(\214le.)2.82 E .381(If no suitable certi\214cate is installed,)125.64
312
525.6 R F2(shellinaboxd)2.881 E F0 .381(will attempt to in)2.881 F -.2
313
(vo)-.4 G -.1(ke).2 G F2(/usr/bin/openssl)2.98 E F0 .38(and create a)
314
2.88 F(ne)125.64 537.6 Q 2.52(ws)-.25 G .021
315
(elf-signed certi\214cate. This only succeeds if, after dropping pri)
316
-2.52 F(vile)-.25 E(ges,)-.15 E F2(shellinaboxd)2.521 E F0 .021
317
(has write per)2.521 F(-)-.2 E(missions for)125.64 549.6 Q F3(certdir)
318
2.5 E F0(.).73 E .26(Most bro)125.64 573.6 R .26(wsers sho)-.25 F 2.76
319
(waw)-.25 G .259(arning message when encountering a self-signed certi\
320
\214cate and then allo)-2.86 F 2.759(wt)-.25 G(he)-2.759 E 1.412(user t\
321
he option of accepting the certi\214cate. Due to this usability problem\
322
, and due to the percei)125.64 585.6 R -.15(ve)-.25 G(d).15 E 1.708(sec\
323
urity implications, the use of auto-generated self-signed certi\214cate\
324
s is intended for testing or in)125.64 597.6 R(intranet deplo)125.64
325
609.6 Q(yments, only)-.1 E(.)-.65 E F2(--cert-fd=)108 626.4 Q F3(fd)A F0
326
.658(Instead of pro)125.64 638.4 R .658(viding a)-.15 F F2(--cert)3.158
327
E F0(directory)3.158 E 3.158(,i)-.65 G 3.158(ti)-3.158 G 3.158(sa)-3.158
328
G .658(lso possible to pro)-3.158 F .658(vide a \214ledescriptor)-.15 F
329
F3(fd)5.129 E F0 .659(where the cer)3.929 F(-)-.2 E 1.087
330
(ti\214cate and k)125.64 650.4 R 1.387 -.15(ey c)-.1 H 1.087
331
(an be retrie).15 F -.15(ve)-.25 G 1.087(d. While this option disables)
332
.15 F F2(SNI)3.587 E F0 1.087(support, it does of)3.587 F 1.086
333
(fer an alternati)-.25 F -.15(ve)-.25 G(solution for securely pro)125.64
334
662.4 Q(viding the pri)-.15 E -.25(va)-.25 G(te k).25 E .3 -.15(ey d)-.1
335
H(ata to the daemon.).15 E F2(--css=)108 679.2 Q F3(\214lename)A F0 .136
336
(Sometimes, it is not necessary to replace the entire style sheet using\
337
 the)125.64 691.2 R F2(--static-\214le)2.637 E F0 .137
338
(option. But instead)2.637 F 3.108(as)125.64 703.2 S .608(mall incremen\
339
tal change should be made to the visual appearance of the terminal. The)
340
-3.108 F F2(--css)3.107 E F0(option)3.107 E(pro)125.64 715.2 Q .585
341
(vides a means to append additional style rules to the end of the def)
342
-.15 F(ault)-.1 E F2(styles.css)3.086 E F0 .586(sheet. More than)3.086 F
343
(one)125.64 727.2 Q F2(--css)2.5 E F0(option can be gi)2.5 E -.15(ve)
344
-.25 G 2.5(no).15 G 2.5(nt)-2.5 G(he same command line.)-2.5 E
345
(Sep 11, 2010)279.75 768 Q(1)202.75 E 0 Cg EP
346
%%Page: 2 2
347
%%BeginPageSetup
348
BP
349
%%EndPageSetup
350
/F0 10/Times-Roman@0 SF(SHELLIN)72 48 Q(ABO)-.35 E 289.26
351
(XD\(1\) SHELLIN)-.4 F(ABO)-.35 E(XD\(1\))-.4 E/F1 10/Times-Bold@0 SF
352
(--cgi)108 84 Q F0([)A F1(=)A/F2 10/Times-Italic@0 SF(portr)A(ang)-.15 E
353
(e)-.1 E F0(])A .2(Instead of running)125.64 96 R F1(shellinaboxd)2.7 E
354
F0 .2(as a permanent process, it can be demand-loaded as a CGI web serv)
355
2.7 F(er)-.15 E -.15(ex)125.64 108 S .569
356
(tension. When doing so, it will spa).15 F .569(wn a serv)-.15 F .569
357
(er that li)-.15 F -.15(ve)-.25 G 3.07(sf).15 G .57
358
(or the duration of the user')-3.07 F 3.07(ss)-.55 G .57(ession. If an)
359
-3.07 F(optional)125.64 120 Q F2(portr)4.453 E(ang)-.15 E(e)-.1 E F0
360
.703(of the form)3.383 F F1(MINPOR)3.202 E -.92(T-)-.4 G(MAXPOR).92 E(T)
361
-.4 E F0 .702(has been pro)3.202 F .702(vided, the serv)-.15 F .702
362
(er limits itself to)-.15 F(these port numbers. The)125.64 132 Q 2.5(ys)
363
-.15 G(hould be con\214gured to pass through the \214re)-2.5 E -.1(wa)
364
-.25 G(ll.).1 E(The)125.64 156 Q F1(--cgi)2.5 E F0(option is mutually e)
365
2.5 E(xclusi)-.15 E .3 -.15(ve w)-.25 H(ith the).15 E F1(--backgr)2.5 E
366
(ound)-.18 E F0(,)A F1(--pid\214le)2.5 E F0(and)2.5 E F1(--port)2.5 E F0
367
(options.)2.5 E .804(In order to be useful as a CGI script, the)125.64
368
180 R F1(shellinaboxd)3.304 E F0 .804(binary probably will ha)3.304 F
369
1.104 -.15(ve t)-.2 H 3.304(ob).15 G 3.304(em)-3.304 G(ade)-3.304 E F1
370
(setuid-)3.304 E -.18(ro)125.64 192 S(ot).18 E F0 5(.T)C
371
(his is currently a discouraged con\214guration. Use with care.)-5 E F1
372
(-d)108 208.8 Q F0(|)2.5 E F1(--deb)2.5 E(ug)-.2 E F0 .822(Enables deb)
373
125.64 220.8 R .822(ugging mode, resulting in lots of log messages on)
374
-.2 F F2(stderr)3.321 E F0 5.821(.T).73 G .821(his option is mutually e)
375
-5.821 F(xclu-)-.15 E(si)125.64 232.8 Q .3 -.15(ve w)-.25 H(ith).15 E F1
376
(--quiet)2.5 E F0(and)2.5 E F1(--v)2.5 E(erbose)-.1 E F0(.)A F1(-f)108
377
249.6 Q F0(|)2.5 E F1(--static-\214le=)2.5 E F2(url)A F0(:)A F2(\214le)A
378
F0 .342(The daemon serv)125.64 261.6 R .342(es v)-.15 F .342(arious b)
379
-.25 F .342(uilt-in resources from URLs underneath the)-.2 F F2(service)
380
3.182 E F0 .343(mount points. One or)3.022 F(more)125.64 273.6 Q F1
381
(--static-\214le)4.269 E F0 1.768(options allo)4.269 F 4.268(wf)-.25 G
382
1.768(or o)-4.268 F -.15(ve)-.15 G 1.768
383
(rriding these resources with customized e).15 F 1.768(xternally pro)
384
-.15 F(vided)-.15 E F2(\214les)125.64 285.6 Q F0 5.716(.T).27 G(he)
385
-5.716 E F2(url)3.296 E F0 .717(can either be an absolute or a relati)
386
3.726 F 1.017 -.15(ve p)-.25 H .717(ath. In the former case, it o).15 F
387
-.15(ve)-.15 G .717(rrides e).15 F .717(xactly one)-.15 F -.2(bu)125.64
388
297.6 S 1.691(ilt-in resource for one speci\214c).2 F F2(service)4.191 E
389
F0 4.191(,w).18 G 1.691(hereas in the latter case it o)-4.191 F -.15(ve)
390
-.15 G 1.69(rrides resources for each).15 F(de\214ned)125.64 309.6 Q F2
391
(service)2.5 E F0(.).18 E(The follo)125.64 333.6 Q(wing resources are a)
392
-.25 E -.25(va)-.2 G(ilable for customization:).25 E F1(beep.wa)125.64
393
350.4 Q(v)-.25 E F0(audio sample that gets played whene)195.09 350.4 Q
394
-.15(ve)-.25 G 2.5(rt).15 G(he terminal BEL is sounded.)-2.5 E F1(fa)
395
125.64 367.2 Q(vicon.ico)-.25 E F0 -.1(fa)195.09 367.2 S
396
(vicon image \214le that is displayed in the bro)-.1 E(wser')-.25 E 2.5
397
(sn)-.55 G -.2(av)-2.5 G(ig).2 E(ation bar)-.05 E(.)-.55 E F1
398
(ShellInABox.js)125.64 384 Q F0(Ja)195.09 384 Q -.25(va)-.2 G
399
(Script \214le implementing the AJ).25 E(AX terminal emulator)-.6 E(.)
400
-.55 E F1(styles.css)125.64 400.8 Q F0
401
(CSS style \214le that controls the visual appearance of the terminal.)
402
195.09 400.8 Q F1(print-styles.css)125.64 417.6 Q F0 1.513(CSS style \
403
\214le that controls the visual appearance of printed pages when using \
404
the)195.09 417.6 R(VT100 transparent printing feature.)195.09 429.6 Q
405
.299(It is not recommended to o)125.64 446.4 R -.15(ve)-.15 G .299
406
(rride the root HTML page for a particular).15 F F2(service)2.799 E F0
407
5.299(.I).18 G .298(nstead, mo)-5.299 F .598 -.15(ve t)-.15 H .298
408
(he ser).15 F(-)-.2 E(vice to an anon)125.64 458.4 Q(ymous URL and serv)
409
-.15 E 2.5(ea)-.15 G F2(static-\214le).34 E F0(that references the)2.68
410
E F2(service)2.84 E F0(in an)2.68 E F2(<ifr)2.5 E(ame>)-.15 E F0(.)A
411
.218(Instead of a)125.64 482.4 R F2(\214le)2.719 E F0 2.719(,i).18 G
412
2.719(ti)-2.719 G 2.719(sp)-2.719 G .219(ossible to pro)-2.719 F .219
413
(vide the name of a directory)-.15 F 2.719(.T)-.65 G .219(his turns)
414
-2.719 F F1(shellinaboxd)2.719 E F0 .219(into a simple)2.719 F .896
415
(web serv)125.64 494.4 R .895
416
(er that publishes all of the \214les in that particular directory)-.15
417
F 3.395(.T)-.65 G .895(his option can be helpful when)-3.395 F
418
(publishing a more comple)125.64 506.4 Q 2.5(xr)-.15 G(oot HTML page.)
419
-2.5 E F1(-g)108 523.2 Q F0(|)2.5 E F1(--gr)2.5 E(oup=)-.18 E F2(gid)A
420
F0 1.046(When started as)125.64 535.2 R F1 -.18(ro)3.547 G(ot).18 E F0
421
3.547(,t)C 1.047(he serv)-3.547 F 1.047(er drops most pri)-.15 F(vile)
422
-.25 E 1.047(ges at start up. Unless o)-.15 F -.15(ve)-.15 G 1.047
423
(rridden by the).15 F F1(--gr)3.547 E(oup)-.18 E F0
424
(option, it switches to)125.64 547.2 Q F1(nogr)2.5 E(oup)-.18 E F0(.)A
425
(When already running as an unpri)125.64 571.2 Q(vile)-.25 E(ged user)
426
-.15 E 2.5(,g)-.4 G(roup changes are not possible.)-2.5 E .76(If runnin\
427
g with SSL/TLS support enabled, the certi\214cates must be accessible t\
428
o the unpri)125.64 595.2 R(vile)-.25 E .76(ged user)-.15 F
429
(and/or group that the daemon runs as.)125.64 607.2 Q F1(-h)108 624 Q F0
430
(|)2.5 E F1(--help)2.5 E F0(Display a brief usage message sho)125.64 636
431
Q(wing the v)-.25 E(alid command line parameters.)-.25 E F1(--linkify)
432
108 652.8 Q F0(=[)A F1(none)A F0(|)A F1(normal)A F0(|)A F1(aggr)A(essi)
433
-.18 E -.1(ve)-.1 G F0(]).1 E .715
434
(the daemon attempts to recognize URLs in the terminal output and mak)
435
125.64 664.8 R .715(es them clickable. This is not)-.1 F .649
436
(neccessarily a fool-proof process and both f)125.64 676.8 R .649
437
(alse ne)-.1 F -.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G 3.149(sa).15 G
438
.648(nd f)-3.149 F .648(alse positi)-.1 F -.15(ve)-.25 G 3.148(sa).15 G
439
.648(re possible. By def)-3.148 F(ault,)-.1 E .249
440
(only URLs starting with a well kno)125.64 688.8 R .249(wn protocol of)
441
-.25 F F1(http://)2.749 E F0(,)A F1(https://)2.5 E F0(,)A F1(ftp://)2.5
442
E F0 2.5(,o)C(r)-2.5 E F1(mailto:)2.5 E F0 .25(are recognized. In)2.749
443
F F1(aggr)125.64 700.8 Q(essi)-.18 E -.1(ve)-.1 G F0 .011(mode, an)2.611
444
F .011(ything that looks lik)-.15 F 2.511(eah)-.1 G .01
445
(ostname, URL or e-mail address is recognized, e)-2.511 F -.15(ve)-.25 G
446
2.51(ni).15 G 2.51(fn)-2.51 G(ot)-2.51 E(preceded by a protocol.)125.64
447
712.8 Q(Sep 11, 2010)279.75 768 Q(2)202.75 E 0 Cg EP
448
%%Page: 3 3
449
%%BeginPageSetup
450
BP
451
%%EndPageSetup
452
/F0 10/Times-Roman@0 SF(SHELLIN)72 48 Q(ABO)-.35 E 289.26
453
(XD\(1\) SHELLIN)-.4 F(ABO)-.35 E(XD\(1\))-.4 E/F1 10/Times-Bold@0 SF
454
(--localhost-only)108 84 Q F0(Normally)125.64 96 Q(,)-.65 E F1
455
(shellinaboxd)3.334 E F0 .834(listens on all a)3.334 F -.25(va)-.2 G
456
.834(ilable netw).25 F .834(ork interf)-.1 F .834
457
(aces. When operating behind a re)-.1 F -.15(ve)-.25 G(rse-).15 E 1.185
458
(proxy that is not al)125.64 108 R -.1(wa)-.1 G 1.184(ys desirable. Thi\
459
s command line option tells the daemon to only listen on the).1 F
460
(loopback interf)125.64 120 Q(ace.)-.1 E F1(--no-beep)108 136.8 Q F0
461
.799(not only are audible signals undesired in some w)125.64 148.8 R
462
.799(orking en)-.1 F .799(vironments, b)-.4 F .8(ut bro)-.2 F .8
463
(wser support for media)-.25 F .776(playback is often b)125.64 160.8 R
464
(uggy)-.2 E 3.276(,t)-.65 G .775(oo. Setting this option suppresses all\
465
 audio playback and enables the visual)-3.276 F(bell by def)125.64 172.8
466
Q(ault.)-.1 E F1(-n)108 189.6 Q F0(|)2.5 E F1(--numeric)2.5 E F0 1.126
467
(When running in)125.64 201.6 R F1(--v)3.626 E(erbose)-.1 E F0 1.127
468
(mode, the daemon prints an)3.626 F/F2 10/Times-Italic@0 SF(Apac)3.627 E
469
(he)-.15 E F0 1.127(-style log \214le to).18 F F2(stderr)3.627 E F0
470
6.127(.B).73 G 3.627(yd)-6.127 G(ef)-3.627 E(ault,)-.1 E .481
471
(host names of peers get resolv)125.64 213.6 R .481
472
(ed before logging them. As DNS look-ups can be e)-.15 F(xpensi)-.15 E
473
-.15(ve)-.25 G 2.98(,i).15 G 2.98(ti)-2.98 G 2.98(sp)-2.98 G(ossi-)-2.98
474
E(ble to request logging of numeric IP addresses, instead.)125.64 225.6
475
Q F1(--pid\214le=)108 242.4 Q F2(pid\214le)A F0(The)125.64 254.4 Q F1
476
(shellinaboxd)2.5 E F0
477
(daemon can be con\214gured to store its process identi\214er in)2.5 E
478
F2(pid\214le)2.5 E F0(.).18 E F1(-p)108 271.2 Q F0(|)2.5 E F1(--port=)
479
2.5 E F2(port)A F0 .458(Unless o)125.64 283.2 R -.15(ve)-.15 G .458
480
(rridden by this option, the web serv).15 F .459
481
(er listens on port 4200 for incoming HTTP and HTTPS)-.15 F(requests.)
482
125.64 295.2 Q F1(shellinaboxd)125.64 319.2 Q F0 .383(can distinguish b\
483
etween SSL/TLS requests and unencrypted requests. It also kno)2.884 F
484
.383(ws ho)-.25 F(w)-.25 E 1.268(to ne)125.64 331.2 R(gotiate)-.15 E F1
485
(Ser)3.768 E -.1(ve)-.1 G 3.768(rN).1 G 1.268(ame Identi\214cation)
486
-3.768 F F0 3.768(,a)C(llo)-3.768 E 1.268
487
(wing the use of a single port for all types of requests)-.25 F -2.15
488
-.25(ev e)125.64 343.2 T 2.5(nw).25 G(hen virtual hosting.)-2.5 E F1(-s)
489
108 360 Q F0(|)2.5 E F1(--ser)2.5 E(vice=)-.1 E F2(service)A F0
490
(One or more services can be re)125.64 372 Q(gistered on dif)-.15 E
491
(ferent URL paths:)-.25 E F2(SER)165.64 384 Q(VICE)-.18 E F0
492
(:= <url-path> ':')2.5 E F2(APPLICA)2.5 E(TION)-.37 E F0 .201
493
(There is a pre-de\214ned)125.64 408 R F2(application)2.701 E F0 2.701
494
(,')C .201(LOGIN', which causes the daemon to in)-2.701 F -.2(vo)-.4 G
495
-.1(ke).2 G F1(/bin/login)2.8 E F0(requesting)2.7 E .038(the user')
496
125.64 420 R 2.539(sn)-.55 G .039(ame and passw)-2.539 F .039
497
(ord, and starting his login shell. This is the def)-.1 F .039
498
(ault option for the)-.1 F F1 -.18(ro)2.539 G(ot).18 E F0(user)2.539 E
499
2.539(,i)-.4 G(f)-2.539 E(no)125.64 432 Q F1(--ser)2.5 E(vice)-.1 E F0
500
-.1(wa)2.5 G 2.5(sd).1 G(e\214ned. Starting)-2.5 E F1(/bin/login)2.5 E
501
F0(requires)2.5 E F1 -.18(ro)2.5 G(ot).18 E F0(pri)2.5 E(vile)-.25 E
502
(ges.)-.15 E .99(There is another pre-de\214ned)125.64 456 R F2
503
(application)3.49 E F0 3.489(,')C 3.489(SSH'. Instead)-3.489 F .989
504
(of in)3.489 F -.2(vo)-.4 G(king).2 E F1(/bin/login)3.489 E F0 3.489(,i)
505
C 3.489(tc)-3.489 G(alls)-3.489 E F1(ssh)3.489 E F0 5.989(.T)C .989
506
(his is)-5.989 F .07(the def)125.64 468 R .07(ault option for unpri)-.1
507
F(vile)-.25 E .07(ged users, if no)-.15 F F1(--ser)2.571 E(vice)-.1 E F0
508
-.1(wa)2.571 G 2.571(sd).1 G .071(e\214ned. This operation is a)-2.571 F
509
-.25(va)-.2 G .071(ilable to both).25 F(pri)125.64 480 Q(vile)-.25 E
510
.393(ged and re)-.15 F .393(gular users. If the optional)-.15 F F2(host)
511
2.893 E F0 .393(parameter is omitted,)2.893 F F1(shellinaboxd)2.893 E F0
512
.392(connects to)2.893 F F1(local-)2.892 E(host)125.64 492 Q F0(.)A
513
(Alternati)125.64 516 Q -.15(ve)-.25 G(ly).15 E 2.776(,a)-.65 G(n)-2.776
514
E F2(application)2.776 E F0 .276(can be speci\214ed by pro)2.776 F .276
515
(viding a)-.15 F F2(user)2.777 E F0 .277(description, a w)2.777 F .277
516
(orking directory)-.1 F 2.777(,a)-.65 G(nd)-2.777 E 2.5(ac)125.64 528 S
517
(ommand line:)-2.5 E F2(APPLICA)165.64 540 Q(TION)-.37 E F0
518
(:= 'LOGIN' | 'SSH' [ ':' <host> ] |)2.5 E F2(USER)5 E F0(':')2.5 E F2
519
(CWD)2.5 E F0(':')2.5 E F2(CMD)2.5 E F0 .62(The k)125.64 564 R -.15(ey)
520
-.1 G -.1(wo).15 G .62(rd 'A).1 F .619(UTH' indicates that the)-.55 F F2
521
(user)3.119 E F0 .619(information should be requested interacti)3.119 F
522
-.15(ve)-.25 G(ly).15 E 3.119(,i)-.65 G .619(nstead of)-3.119 F
523
(being pro)125.64 576 Q(vided as part of the)-.15 E F2(service)2.5 E F0
524
(description:)2.5 E F2(USER)165.64 588 Q F0(:= 'A)2.5 E
525
(UTH' | <username> ':' <groupname>)-.55 E(The w)125.64 612 Q
526
(orking directory can either be gi)-.1 E -.15(ve)-.25 G 2.5(na).15 G 2.5
527
(sa)-2.5 G 2.5(na)-2.5 G(bsolute path, or it can be the user')-2.5 E 2.5
528
(sh)-.55 G(ome directory:)-2.5 E F2(CWD)165.64 624 Q F0
529
(:= 'HOME' : <dir>)2.5 E .973(The command that)125.64 648 R F1
530
(shellinaboxd)3.473 E F0 -.15(exe)3.473 G .973
531
(cutes can either be speci\214ed as the 'SHELL).15 F 3.473('k)-.92 G
532
-.15(ey)-3.573 G -.1(wo).15 G .974(rd, denoting).1 F(the user')125.64
533
660 Q 2.5(sd)-.55 G(ef)-2.5 E
534
(ault login shell, or an arbitrary command line:)-.1 E F2(CMD)165.64 672
535
Q F0(:= 'SHELL)2.5 E 2.5(':<)-.92 G(cmdline>)-2.5 E
536
(The <cmdline> supports e)125.64 696 Q(xpansion of v)-.15 E
537
(ariables of the form ${V)-.25 E 2.5(AR}. Supported)-1.35 F -.25(va)2.5
538
G(riables are:).25 E F1(${columns})125.64 712.8 Q F0(number of columns.)
539
179.13 712.8 Q(Sep 11, 2010)279.75 768 Q(3)202.75 E 0 Cg EP
540
%%Page: 4 4
541
%%BeginPageSetup
542
BP
543
%%EndPageSetup
544
/F0 10/Times-Roman@0 SF(SHELLIN)72 48 Q(ABO)-.35 E 289.26
545
(XD\(1\) SHELLIN)-.4 F(ABO)-.35 E(XD\(1\))-.4 E/F1 10/Times-Bold@0 SF
546
(${gid})125.64 84 Q F0(numeric group id.)179.13 84 Q F1(${gr)125.64
547
100.8 Q(oup})-.18 E F0(group name.)179.13 100.8 Q F1(${home})125.64
548
117.6 Q F0(home directory)179.13 117.6 Q(.)-.65 E F1(${lines})125.64
549
134.4 Q F0(number of ro)179.13 134.4 Q(ws.)-.25 E F1(${peer})125.64
550
151.2 Q F0(name of remote peer)179.13 151.2 Q(.)-.55 E F1(${uid})125.64
551
168 Q F0(numeric user id.)179.13 168 Q F1(${url})125.64 184.8 Q F0
552
(the URL that serv)179.13 184.8 Q(es the terminal session.)-.15 E F1
553
(${user})125.64 201.6 Q F0(user name.)179.13 201.6 Q 1.542
554
(Other than the def)125.64 218.4 R 1.542(ault en)-.1 F 1.542
555
(vironment v)-.4 F 1.542(ariables of)-.25 F F1($TERM)4.042 E F0(,)A F1
556
($COLUMNS)4.042 E F0(and)4.041 E F1($LINES)4.041 E F0 4.041(,s)C 1.541
557
(ervices can)-4.041 F(ha)125.64 230.4 Q .725 -.15(ve e)-.2 H -.4(nv).15
558
G .425(ironment v).4 F .425(ariables passed to them, by preceding the <\
559
cmdline> with space separated v)-.25 F(ariable)-.25 E
560
(assignments of the form)125.64 242.4 Q/F2 10/Times-Italic@0 SF(KEY)2.5
561
E F0(=)1.27 E F2 -.6(VA)C(LUE).6 E F0(.).73 E .099(The <cmdline> suppor\
562
ts single and double quotes, as well as backslashes for escaping charac\
563
ters in the)125.64 266.4 R -.1(fa)125.64 278.4 S(miliar f).1 E(ashion.)
564
-.1 E .572(Please note that when in)125.64 302.4 R -.2(vo)-.4 G(king).2
565
E F1(shellinaboxd)3.072 E F0 .572
566
(from a command line shell, additional quoting might be)3.072 F
567
(required to pre)125.64 314.4 Q -.15(ve)-.25 G(nt the shell from e).15 E
568
(xpanding the v)-.15 E(ariables prior to passing them to the daemon.)
569
-.25 E .214(If no e)125.64 338.4 R(xplicit)-.15 E F1(--ser)2.714 E(vice)
570
-.1 E F0 .214(has been requested,)2.714 F F1(shellinaboxd)2.714 E F0
571
(def)2.714 E .214(aults to attaching the def)-.1 F .214
572
(ault service to the)-.1 F 1.436(root directory of the web serv)125.64
573
350.4 R(er)-.15 E 3.936(.F)-.55 G(or)-4.086 E F1 -.18(ro)3.936 G(ot).18
574
E F0 3.936(,t)C 1.436(his is)-3.936 F F1(/bin/login)3.937 E F0 3.937(,a)
575
C 1.437(nd for unpri)-3.937 F(vile)-.25 E 1.437(ged users, this is)-.15
576
F F1(ssh)3.937 E(localhost)125.64 362.4 Q F0 2.5(.T)C(his is equi)-2.5 E
577
-.25(va)-.25 G(lent to saying).25 E F1(--ser)2.5 E(vice=/:LOGIN)-.1 E F0
578
2.5(,o)C(r)-2.5 E F1(--ser)2.5 E(vice=/:SSH)-.1 E F0 2.5(,r)C(especti)
579
-2.5 E -.15(ve)-.25 G(ly).15 E(.)-.65 E F1(-t)108 379.2 Q F0(|)2.5 E F1
580
(--disable-ssl)2.5 E F0 .832(By def)125.64 391.2 R(ault,)-.1 E F1
581
(shellinaboxd)3.332 E F0 .832
582
(redirectes all incoming HTTP requests to their equi)3.332 F -.25(va)
583
-.25 G .831(lent HTTPS URLs. If).25 F(promoting of connections to encry\
584
pted SSL/TLS sessions is undesired, this beha)125.64 403.2 Q
585
(vior can be disabled.)-.2 E .819
586
(This option is also useful during testing or for deplo)125.64 427.2 R
587
.819(yment in trusted intranets, if SSL certi\214cates are)-.1 F(una)
588
125.64 439.2 Q -.25(va)-.2 G(ilable.).25 E F1(--disable-ssl-menu)108 456
589
Q F0 .216(If the user should not be able to switch between HTTP and HTT\
590
PS modes, this choice can be remo)125.64 468 R -.15(ve)-.15 G(d).15 E
591
(from the conte)125.64 480 Q(xt menu. The user can still mak)-.15 E 2.5
592
(et)-.1 G(his choice by directly going to the appropriate URL.)-2.5 E F1
593
(-q)108 496.8 Q F0(|)2.5 E F1(--quiet)2.5 E F0
594
(Surpresses all messages to)125.64 508.8 Q F2(stderr)2.5 E F0 5(.T).73 G
595
(his option is mutually e)-5 E(xclusi)-.15 E .3 -.15(ve w)-.25 H(ith).15
596
E F1(--deb)2.5 E(ug)-.2 E F0(and)2.5 E F1(--v)2.5 E(erbose)-.1 E F0(.)A
597
F1(-u)108 525.6 Q F0(|)2.5 E F1(--user=)2.5 E F2(uid)A F0 .515
598
(If started as)125.64 537.6 R F1 -.18(ro)3.016 G(ot).18 E F0 3.016(,t)C
599
.516(he serv)-3.016 F .516(er drops pri)-.15 F(vile)-.25 E .516
600
(ges by changing to)-.15 F F1(nobody)3.016 E F0 3.016(,u)C .516
601
(nless the)-3.016 F F2(uid)3.096 E F0 .516(has been o)3.786 F -.15(ve)
602
-.15 G(rrid-).15 E(den by this option.)125.64 549.6 Q -.15(Fo)125.64
603
573.6 S 2.5(rm).15 G(ore details, refer to the description of the)-2.5 E
604
F1(--gr)2.5 E(oup)-.18 E F0(option.)2.5 E F1(--user)108 590.4 Q(-css=)
605
-.37 E F2(styles)A F0 .23(The visual appearance of the terminal emulato\
606
r can be customized through user)125.64 602.4 R .23
607
(-selectable style sheets.)-.2 F(These style sheets will sho)125.64
608
614.4 Q 2.5(wu)-.25 G 2.5(pa)-2.5 G 2.5(so)-2.5 G
609
(ptions in the right-click conte)-2.5 E
610
(xt menu of the terminal emulator)-.15 E(.)-.55 E 1.391
611
(Styles sheet mak)125.64 638.4 R 3.891(eu)-.1 G 3.891(pe)-3.891 G 1.391
612
(ither independently selectable on/of)-3.891 F 3.891(fo)-.25 G 1.392
613
(ptions, or multiple style sheets can be)-3.891 F 1.118
614
(grouped together)125.64 650.4 R 3.618(.W)-.55 G 1.118
615
(hen forming a group, only one member of the group can be acti)-3.618 F
616
1.417 -.15(ve a)-.25 H 3.617(ta).15 G 1.417 -.15(ny g)-3.617 H -2.15
617
-.25(iv e).15 H(n).25 E(time. This is used for multiple-choice options.)
618
125.64 662.4 Q(Multiple independent groups are separated by semicolons:)
619
125.64 686.4 Q F2(STYLES)165.64 698.4 Q F0(:=)2.5 E F2(GR)2.5 E(OUP)-.4
620
E F0 2.5({')2.5 G(;')-2.5 E F2(GR)2.5 E(OUP)-.4 E F0(}*)2.5 E
621
(The members of a group are separated by commas:)125.64 722.4 Q
622
(Sep 11, 2010)279.75 768 Q(4)202.75 E 0 Cg EP
623
%%Page: 5 5
624
%%BeginPageSetup
625
BP
626
%%EndPageSetup
627
/F0 10/Times-Roman@0 SF(SHELLIN)72 48 Q(ABO)-.35 E 289.26
628
(XD\(1\) SHELLIN)-.4 F(ABO)-.35 E(XD\(1\))-.4 E/F1 10/Times-Italic@0 SF
629
(GR)165.64 84 Q(OUP)-.4 E F0(:=)2.5 E F1(OPTION)2.5 E F0 2.5({')2.5 G
630
1.4 -.7(,' O)-2.5 H(PTION }*).7 E(Groups with e)125.64 108 Q(xactly one\
631
 member are used for options that can be independently turned on and of)
632
-.15 E(f.)-.25 E .396
633
(Options include a human readable label that will be sho)125.64 132 R
634
.396(wn in the conte)-.25 F .396(xt menu, follo)-.15 F .396
635
(wed by the name)-.25 F 1.219(of the CSS \214le. The)125.64 144 R 3.718
636
(ya)-.15 G 1.218(lso must include an indicator sho)-3.718 F 1.218
637
(wing whether the option should initially be)-.25 F
638
(turned on or turned of)125.64 156 Q(f. W)-.25 E(ithin a group, e)-.4 E
639
(xactly one option should be turned on:)-.15 E F1(OPTION)165.64 168 Q F0
640
(:= <label> ':' [ '-' | '+' ] <css-\214le>)2.5 E .215(The user')125.64
641
192 R 2.715(ss)-.55 G .215
642
(election of options will be persisted in a cookie. This means, the def)
643
-2.715 F .216(ault settings of options)-.1 F .15
644
(as passed on the command line only tak)125.64 204 R .15(es ef)-.1 F
645
.149(fect the v)-.25 F .149
646
(ery \214rst time the user visits the terminal emulator)-.15 F
647
(in his bro)125.64 216 Q(wser)-.25 E 2.5(.O)-.55 G 2.5(na)-2.5 G
648
(ll subsequent visits, the user')-2.5 E 2.5(sp)-.55 G(references tak)
649
-2.5 E 2.5(ep)-.1 G(recedence.)-2.5 E/F2 10/Times-Bold@0 SF(-v)108 232.8
650
Q F0(|)2.5 E F2(--v)2.5 E(erbose)-.1 E F0 .234(Enables logging of)125.64
651
244.8 R F1(Apac)2.734 E(he)-.15 E F0 .234(-style log \214le to).18 F F1
652
(stderr)2.735 E F0 5.235(.T).73 G .235(his option is mutually e)-5.235 F
653
(xclusi)-.15 E .535 -.15(ve w)-.25 H(ith).15 E F2(--deb)2.735 E(ug)-.2 E
654
F0(and)2.735 E F2(--quiet)125.64 256.8 Q F0(.)A F2(--v)108 273.6 Q
655
(ersion)-.1 E F0(Prints the v)125.64 285.6 Q
656
(ersion number of the binary and e)-.15 E(xits.)-.15 E/F3 10.95
657
/Times-Bold@0 SF(CONFIGURA)72 302.4 Q(TION)-1.04 E F0
658
(There are no con\214guration \214les or permanent settings for)108
659
314.4 Q F2(shellinaboxd)2.5 E F0(.)A 2.542(As)108 338.4 S .042
660
(mall number of run-time con\214guration options are a)-2.542 F -.25(va)
661
-.2 G .041(ilable from a conte).25 F .041(xt menu that becomes a)-.15 F
662
-.25(va)-.2 G(ilable).25 E(when clicking the right mouse b)108 350.4 Q
663
(utton. These options get persisted in a bro)-.2 E(wser cookie.)-.25 E
664
(Man)108 374.4 Q 3.15(ys)-.15 G .65(ites already ha)-3.15 F .95 -.15
665
(ve a w)-.2 H .65(eb serv).15 F .651(er running and w)-.15 F .651
666
(ould lik)-.1 F 3.151(et)-.1 G 3.151(oi)-3.151 G(nte)-3.151 E(grate)-.15
667
E F2(shellinaboxd)3.151 E F0 .651(into their e)3.151 F(xisting)-.15 E
668
.497(site. This is most commonly done by means of a re)108 386.4 R -.15
669
(ve)-.25 G .497(rse-proxy entry for the main web serv).15 F(er)-.15 E
670
2.997(.F)-.55 G(or)-3.147 E F1(Apac)4.007 E(he)-.15 E F0(this w)108
671
398.4 Q(ould require adding an option such as:)-.1 E(<Location /shell>)
672
150.5 410.4 Q(ProxyP)160.5 422.4 Q 2.5(ass http://localhost:4200/)-.15 F
673
12.5(Order allo)160.5 434.4 R -.65(w,)-.25 G(den).65 E(y)-.15 E(Allo)
674
160.5 446.4 Q 15(wf)-.25 G(rom all)-15 E(</Location>)150.5 458.4 Q 1.133
675
(If you are using a dif)108 482.4 R 1.133(ferent web serv)-.25 F(er)-.15
676
E 3.633(,r)-.4 G 1.134(efer to that serv)-3.633 F(er')-.15 E 3.634(sd)
677
-.55 G 1.134(ocumentation on ho)-3.634 F 3.634(wt)-.25 G 3.634(oc)-3.634
678
G 1.134(on\214gure re)-3.634 F -.15(ve)-.25 G(rse).15 E
679
(proxy operations.)108 494.4 Q .751(When using a re)108 518.4 R -.15(ve)
680
-.25 G .751(rse proxy).15 F 3.251(,t)-.65 G(he)-3.251 E F2
681
(--localhost-only)3.251 E F0 .751(option w)3.251 F .75
682
(ould normally be enabled as well.)-.1 F .75(In addition,)5.75 F(the)108
683
530.4 Q F2(--disable-ssl)2.5 E F0
684
(might also be considered depending on the e)2.5 E
685
(xact con\214guration details of the re)-.15 E -.15(ve)-.25 G(rse proxy)
686
.15 E(.)-.65 E F3(EXAMPLES)72 547.2 Q F2(shellinaboxd)108 559.2 Q F0 .8
687
(Attaches a web-enabled login shell to)161.61 571.2 R F1
688
(https://localhost:4200/)3.3 E F0 5.8(.I)1.58 G 3.3(ft)-5.8 G .8
689
(he user connected without)-3.3 F .383
690
(SSL, the session will automatically be promoted.)161.61 583.2 R .383
691
(Unless SSL certi\214cates can be found in the)5.383 F 1.19
692
(current directory)161.61 595.2 R 3.69(,t)-.65 G 1.19(he daemon will au\
693
tomatically generate suitable self-signed certi\214cates. If)-3.69 F
694
.654(the command w)161.61 607.2 R .654(as in)-.1 F -.2(vo)-.4 G -.1(ke)
695
.2 G 3.154(db).1 G 3.154(ya)-3.154 G(non-)-.001 E F2 -.18(ro)C(ot).18 E
696
F0(user)3.153 E 3.153(,t)-.4 G .653(he daemon uses)-3.153 F F2(ssh)3.153
697
E F0 .653(instead of)3.153 F F2(/bin/login)3.153 E F0(for)3.153 E
698
(the session.)161.61 619.2 Q F2(shellinaboxd -t)108 636 Q F0
699
(Attaches a web-enabled login shell to)161.61 648 Q F1
700
(http://localhost:4200/)2.81 E F0(with SSL/TLS support disabled.)4.08 E
701
F2(shellinaboxd -t -f beep.wa)108 664.8 Q(v:/de)-.25 E(v/null)-.15 E F0
702
(Runs all services with the audible-bell permanently disabled.)161.61
703
676.8 Q F2(shellinaboxd -s /:SSH:example.or)108 693.6 Q(g)-.1 E F0
704
(The terminal connects to a)161.61 705.6 Q F2(ssh)2.5 E F0(session on)
705
2.5 E F1 -.2(ex)2.5 G(ample).2 E(.or)-.15 E(g)-.37 E F0(.).22 E
706
(Sep 11, 2010)279.75 768 Q(5)202.75 E 0 Cg EP
707
%%Page: 6 6
708
%%BeginPageSetup
709
BP
710
%%EndPageSetup
711
/F0 10/Times-Roman@0 SF(SHELLIN)72 48 Q(ABO)-.35 E 289.26
712
(XD\(1\) SHELLIN)-.4 F(ABO)-.35 E(XD\(1\))-.4 E/F1 10/Times-Bold@0 SF
713
(shellinaboxd -t -s /:A)108 84 Q(UTH:HOME:/bin/bash)-.5 E F0(Interacti)
714
161.61 96 Q -.15(ve)-.25 G 1.372(ly request the user').15 F 3.872(sn)
715
-.55 G 1.372(ame and passw)-3.872 F 1.373
716
(ord prior to launching a Bourne shell. This)-.1 F .359
717
(command can be run by unpri)161.61 108 R(vile)-.25 E .359
718
(ged users. But if doing so, it only allo)-.15 F .358
719
(ws this particular user)-.25 F(to log in.)161.61 120 Q F1
720
(shellinaboxd -c certi\214cates -u shellinabox -g shellinabox)108 136.8
721
Q F0 1.467(If the)161.61 148.8 R F1(certi\214cates)3.967 E F0 1.467
722
(directory e)3.967 F 1.467(xists and is writable by the)-.15 F F1
723
(shellinabox)3.967 E F0 1.468(user and group, self-)3.967 F 1.853
724
(signed SSL certi\214cates will be generated in this directory)161.61
725
160.8 R 4.353(.T)-.65 G 1.853(his might require creating an)-4.353 F
726
.365(appropriately named user \214rst.)161.61 172.8 R .366
727
(Running this command as)5.365 F F1 -.18(ro)2.866 G(ot).18 E F0(allo)
728
2.866 E .366(ws an)-.25 F 2.866(yu)-.15 G .366(ser on the system)-2.866
729
F(to log in at)161.61 184.8 Q F1(http://localhost:4200/)2.5 E F0 5(.S)C
730
(essions will automatically be promoted to SSL/TLS.)-5 E F1
731
(shellinaboxd -t -s /:LOGIN -s /who:nobody:nogr)108 201.6 Q(oup:/:w)-.18
732
E F0 .546(In addition to the login shell at)161.61 213.6 R/F2 10
733
/Times-Italic@0 SF(http://localhost:4200)3.045 E F0 3.045(,s).47 G(ho)
734
-3.045 E 3.045(wal)-.25 G .545(ist of currently logged in users)-3.045 F
735
.413(when accessing)161.61 225.6 R F2(http://localhost:4200/who)2.913 E
736
F0 5.413(.T).18 G .413(his command must be run as)-5.413 F F1 -.18(ro)
737
2.913 G(ot).18 E F0 .413(in order to be)2.913 F(able to change to)161.61
738
237.6 Q F1(nobody:nogr)2.5 E(oup)-.18 E F0
739
(as requested by the service description.)2.5 E F1
740
(shellinaboxd -t -s '/:r)108 254.4 Q(oot:r)-.18 E
741
(oot:/:wy60 -c /bin/login')-.18 E F0 1.659(Instead of the standard)
742
161.61 266.4 R F1(ANSI/VT100)4.159 E F0 1.658(terminal, publish a)4.158
743
F F1 -.6(Wy)4.158 G 1.658(se 60\007).6 F F0 1.658(terminal. Ag)4.158 F
744
1.658(ain, this)-.05 F(command should be run as)161.61 278.4 Q F1 -.18
745
(ro)2.5 G(ot).18 E F0(.)A F1(shellinaboxd --css white-on-black.css)108
746
295.2 Q F0 1.717(Loads the)161.61 307.2 R F1(white-on-black.css)4.217 E
747
F0 1.718(style sheet from the current directory and appends it to the)
748
4.217 F -.2(bu)161.61 319.2 S(ilt-in).2 E F1(styles.css)2.823 E F0 .323
749
(sheet. This causes the terminal to al)2.823 F -.1(wa)-.1 G .323
750
(ys render white te).1 F .322(xt on a black back-)-.15 F(ground.)161.61
751
331.2 Q F1(shellinaboxd --user)108 348 Q
752
(-css Normal:+black-on-white.css,Re)-.37 E -.1(ve)-.15 G
753
(rse:-white-on-black.css).1 E F0(Allo)161.61 360 Q 3.32(wt)-.25 G .82
754
(he user to select whether the)-3.32 F 3.321(yw)-.15 G .821(ant te)
755
-3.421 F .821(xt to be rendered normally or in re)-.15 F -.15(ve)-.25 G
756
.821(rse video.).15 F(This command line option adds a ne)161.61 372 Q
757
2.5(we)-.25 G(ntry to the right-click conte)-2.5 E(xt menu.)-.15 E/F3
758
10.95/Times-Bold@0 SF(DIA)72 388.8 Q(GNOSTICS)-.602 E F0 .504
759
(The daemon returns a non-zero e)108 400.8 R .504(xit code in case of f)
760
-.15 F .504(ailure. W)-.1 F .504(ith the e)-.4 F .503
761
(xception of a small number of com-)-.15 F 1.04
762
(mon error cases that are handled e)108 412.8 R(xplicitly)-.15 E 3.541
763
(,m)-.65 G 1.041(ost errors result in printing a)-3.541 F F2("Chec)2.601
764
E 3.541(kf)-.2 G(ailed")-3.541 E F0 1.041(message. This)4.161 F
765
(does not typically indicate a b)108 424.8 Q(ug in the program b)-.2 E
766
(ut is instead its normal w)-.2 E(ay of reporting errors.)-.1 E .072
767
(Common f)108 448.8 R .071(ailure conditions are reusing a port that is\
768
 already in use, lack of suf)-.1 F .071(\214cient pri)-.25 F(vile)-.25 E
769
.071(ges to run a ser)-.15 F(-)-.2 E .78(vice, f)108 460.8 R .78
770
(ailure to \214nd SSL/TLS certi\214cates, and f)-.1 F .78
771
(ailure to write ne)-.1 F .78
772
(wly generated certi\214cates to the certi\214ca-)-.25 F(tion directory)
773
108 472.8 Q(.)-.65 E F3(SEE ALSO)72 489.6 Q F1(chmod)108 501.6 Q F0
774
(\(1\),)A F1(last)2.5 E F0(\(1\),)A F1(login)2.5 E F0(\(1\),)A F1(sh)2.5
775
E F0(\(1\),)A F1(shells)2.5 E F0(\(5\),)A F1(openssl)2.5 E F0(\(1SSL\),)
776
A F1(w)2.5 E F0(\(1\),)A F1(wy60)2.5 E F0(\(1\),)A F1(xterm)2.5 E F0
777
(\(1\).)A F3(SECURITY)72 518.4 Q F0 .89(The daemon uses pri)108 530.4 R
778
(vile)-.25 E .89(ge separation techniques to allo)-.15 F 3.39(wi)-.25 G
779
3.39(tt)-3.39 G 3.39(od)-3.39 G .89(rop pri)-3.39 F(vile)-.25 E .89
780
(ges early)-.15 F 3.39(.I)-.65 G 3.39(ti)-3.39 G 3.39(sa)-3.39 G -.1(wa)
781
-3.54 G .89(re of setuid).1 F(\215ags and restricts some operations whe\
782
n launched as a setuid application.)108 542.4 Q .395
783
(Despite these safety features, a b)108 566.4 R .395(ug could concei)-.2
784
F -.25(va)-.25 G .395(bly lead to a determined attack).25 F .396(er g)
785
-.1 F .396(aining ele)-.05 F -.25(va)-.25 G .396(ted pri).25 F(vi-)-.25
786
E(le)108 578.4 Q(ges. It is therefore strongly discouraged to set the s\
787
etuid \215ag on the binary)-.15 E(.)-.65 E .578(The e)108 602.4 R .578
788
(xpected deplo)-.15 F .578(yment w)-.1 F .578(ould be from a system)-.1
789
F F2 -.37(rc)3.078 G F0 .577(script launched by)3.757 F F1(/sbin/init)
790
3.077 E F0 5.577(.F)C .577(or e)-5.727 F .577(xtra security)-.15 F 3.077
791
(,t)-.65 G(he)-3.077 E F1(--gr)108 614.4 Q(oup)-.18 E F0(and)2.5 E F1
792
(--user)2.5 E F0(options should be used to change to a dedicated user)
793
2.5 E(.)-.55 E F3 -.548(AU)72 631.2 S(THOR).548 E F0(Cop)108 643.2 Q
794
(yright \(C\) 2008-2010 by Markus Gutschk)-.1 E 2.5(e<)-.1 G F2
795
(markus@shellinabox.com)-2.12 E F0(>.).32 E .286
796
(This program is free softw)108 660 R .286(are; you can redistrib)-.1 F
797
.287(ute it and/or modify it under the terms of the GNU General)-.2 F
798
(Public License v)108 672 Q(ersion 2 as published by the Free Softw)-.15
799
E(are F)-.1 E(oundation.)-.15 E .58(This program is distrib)108 688.8 R
800
.579(uted in the hope that it will be useful, b)-.2 F .579
801
(ut WITHOUT ANY W)-.2 F(ARRANTY)-1.2 E 3.079(;w)-.92 G(ithout)-3.079 E
802
-2.15 -.25(ev e)108 700.8 T 2.729(nt).25 G .229(he implied w)-2.729 F
803
.229(arranty of MERCHANT)-.1 F .229(ABILITY or FITNESS FOR A P)-.93 F
804
(AR)-.92 E .23(TICULAR PURPOSE.)-.6 F(See)5.23 E
805
(the GNU General Public License for more details.)108 712.8 Q -1.1(Yo)
806
108 729.6 S 2.77(us)1.1 G .27(hould ha)-2.77 F .57 -.15(ve r)-.2 H(ecei)
807
.15 E -.15(ve)-.25 G 2.77(dac).15 G(op)-2.77 E 2.77(yo)-.1 G 2.77(ft)
808
-2.77 G .27
809
(he GNU General Public License along with this program; if not, write)
810
-2.77 F(Sep 11, 2010)279.75 768 Q(6)202.75 E 0 Cg EP
811
%%Page: 7 7
812
%%BeginPageSetup
813
BP
814
%%EndPageSetup
815
/F0 10/Times-Roman@0 SF(SHELLIN)72 48 Q(ABO)-.35 E 289.26
816
(XD\(1\) SHELLIN)-.4 F(ABO)-.35 E(XD\(1\))-.4 E(to the Free Softw)108 84
817
Q(are F)-.1 E(oundation, Inc., 59 T)-.15 E
818
(emple Place, Suite 330, Boston, MA)-.7 E(02111-1307 USA)5 E
819
(In addition to these license terms, the author grants the follo)108
820
100.8 Q(wing additional rights:)-.25 E .756
821
(If you modify this program, or an)108 117.6 R 3.256(yc)-.15 G -.15(ove)
822
-3.256 G .756(red w).15 F .757
823
(ork, by linking or combining it with the OpenSSL project')-.1 F(s)-.55
824
E 1.98(OpenSSL library \(or a modi\214ed v)108 129.6 R 1.98
825
(ersion of that library\), containing parts co)-.15 F -.15(ve)-.15 G
826
1.98(red by the terms of the).15 F 1.234(OpenSSL or SSLeay licenses, th\
827
e author grants you additional permission to con)108 141.6 R 1.535 -.15
828
(vey t)-.4 H 1.235(he resulting w).15 F(ork.)-.1 E .894(Corresponding S\
829
ource for a non-source form of such a combination shall include the sou\
830
rce code for the)108 153.6 R
831
(parts of OpenSSL used as well as that of the co)108 165.6 Q -.15(ve)
832
-.15 G(red w).15 E(ork.)-.1 E -1.1(Yo)108 182.4 S 2.5(um)1.1 G
833
(ay at your option choose to remo)-2.5 E .3 -.15(ve t)-.15 H
834
(his additional permission from the w).15 E(ork, or from an)-.1 E 2.5
835
(yp)-.15 G(art of it.)-2.5 E 2.094(If you w)108 199.2 R 2.094(ould lik)
836
-.1 F 4.594(et)-.1 G 4.594(on)-4.594 G -.15(eg)-4.594 G 2.095
837
(otiate dif).15 F 2.095
838
(ferent licensing terms that are compatible for inte)-.25 F 2.095
839
(gration with other)-.15 F(projects, please contact the author)108 211.2
840
Q(.)-.55 E .276
841
(If the OpenSSL system libraries can be found at run-time, the)108 228 R
842
2.776(yw)-.15 G .276(ill be in)-2.776 F -.2(vo)-.4 G -.1(ke).2 G 2.776
843
(db).1 G(y)-2.776 E/F1 10/Times-Bold@0 SF(shellinaboxd)2.776 E F0 .275
844
(to pro)2.775 F(vide)-.15 E
845
(SSL/TLS support. The OpenSSL and SSLeay licenses require the follo)108
846
240 Q(wing notices:)-.25 E 2.56(This product includes softw)108 256.8 R
847
2.56(are de)-.1 F -.15(ve)-.25 G 2.56
848
(loped by the OpenSSL Project for use in the OpenSSL T).15 F(oolkit.)-.8
849
E(\(http://www)108 268.8 Q(.openssl.or)-.65 E(g/\))-.18 E
850
(This product includes cryptographic softw)108 285.6 Q
851
(are written by Eric Y)-.1 E(oung \(eay@cryptsoft.com\))-1.1 E/F2 10.95
852
/Times-Bold@0 SF -.11(BU)72 302.4 S(GS).11 E F0(Due to bro)108 314.4 Q
853
(wser limitations, some features might not be a)-.25 E -.25(va)-.2 G
854
(ilable to users of all bro).25 E(wers.)-.25 E -.35(Ko)108 331.2 S .027
855
(nqueror does not allo).35 F 2.526(wf)-.25 G .026
856
(or reliable interception of)-2.526 F/F3 10/Times-Italic@0 SF(CTRL)2.366
857
E F0 -.1(ke)3.056 G .026(ys. If you press a k)-.05 F .326 -.15(ey t)-.1
858
H .026(ogether with the).15 F F3(CTRL)2.366 E F0(modi\214er)108 343.2 Q
859
3.063(,i)-.4 G 3.063(tc)-3.063 G .564(ontinues performing the bro)-3.063
860
F(wser')-.25 E 3.064(sp)-.55 G .564(rede\214ned beha)-3.064 F .564
861
(vior for this particular k)-.2 F .864 -.15(ey c)-.1 H .564
862
(ombination. In).15 F .433(most cases, it also f)108 355.2 R .433
863
(ails to report the correct k)-.1 F .733 -.15(ey t)-.1 H 2.933(ot).15 G
864
.433(he terminal emulator)-2.933 F 2.933(.A)-.55 G 2.932(saw)-2.933 G
865
.432(ork-around, pressing both)-3.032 F(the)108 367.2 Q F3(CTRL)2.34 E
866
F0(and the)3.03 E F3(WINDO)2.29 E(WS)-.5 E F0 -.1(ke)3.08 G 2.5(ys)-.05
867
G(ometimes w)-2.5 E(orks.)-.1 E .048(Some bro)108 384 R .048
868
(wsers, most notably IE on W)-.25 F(indo)-.4 E .049(ws, disallo)-.25 F
869
2.549(wi)-.25 G .049(nterception of)-2.549 F F3(AL)3.559 E(T)-.2 E F0
870
-.1(ke)3.819 G .049(ys and al)-.05 F -.1(wa)-.1 G .049
871
(ys interpret these).1 F -.1(ke)108 396 S 1.441
872
(ys as menu accelerators. As a w)-.05 F 1.441(ork-around, man)-.1 F
873
3.941(yU)-.15 G 1.441(NIX applications allo)-3.941 F 3.94(wp)-.25 G
874
(ressing)-3.94 E F3(ESC)3.94 E F0 3.94(,i).72 G 1.44(nstead of)-3.94 F
875
F3(AL)108 408 Q(T)-.2 E F0(.)1.27 E 1.221(When using non-US k)108 424.8
876
R -.15(ey)-.1 G 1.221(board layouts, some bro).15 F 1.221
877
(wser do not allo)-.25 F 3.722(wf)-.25 G 1.222
878
(or reliably determining shifted)-3.722 F F3(AL)4.732 E(T)-.2 E F0 -.1
879
(ke)108 436.8 S(ys. Please report these cases if the)-.05 E 2.5(yt)-.15
880
G(urn out to be a problem, as w)-2.5 E(ork-arounds might be possible.)
881
-.1 E .887(Access to the nati)108 453.6 R 1.187 -.15(ve c)-.25 H .887(l\
882
ipboard is typically not possible. Instead, an internal clipboard acces\
883
sible from the).15 F(right-b)108 465.6 Q(utton conte)-.2 E
884
(xt menu is used for all b)-.15 E(ut IE.)-.2 E .972(Some bro)108 482.4 R
885
.973(wsers restrict the number of concurrent connections to a serv)-.25
886
F(er)-.15 E 3.473(.T)-.55 G .973(his restricts ho)-3.473 F 3.473(wm)-.25
887
G(an)-3.473 E 3.473(yA)-.15 G -.6(JA)-3.473 G(X).6 E 1.108
888
(terminals can be opened simultaneously)108 494.4 R 3.607(.I)-.65 G
889
3.607(ft)-3.607 G 1.107
890
(his becomes a problem, users can typically recon\214gure their)-3.607 F
891
(bro)108 506.4 Q(wsers to raise the limit.)-.25 E .41(There ha)108 523.2
892
R .71 -.15(ve b)-.2 H .411(een reports of the VLC plugin on Linux/x86_6\
893
4 crashing Firefox when the bro).15 F .411(wser page gets)-.25 F .886
894
(reloaded. Setting the)108 535.2 R F1(--no-beep)3.386 E F0 .885
895
(option eliminates all references to VLC and thus appears to w)3.386 F
896
.885(ork around)-.1 F(this crash.)108 547.2 Q(Sep 11, 2010)279.75 768 Q
897
(7)202.75 E 0 Cg EP
898
%%Trailer
899
end
900
%%EOF
(46-46/56)