~ubuntu-branches/ubuntu/warty/lynx/warty-security

« back to all changes in this revision

Viewing changes to lynx.man

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2004-09-16 12:14:10 UTC
  • Revision ID: james.westby@ubuntu.com-20040916121410-cz1gu92c4nqfeyrg
Tags: upstream-2.8.5
ImportĀ upstreamĀ versionĀ 2.8.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.nr N -1
 
2
.nr D 5
 
3
.TH LYNX 1 Local
 
4
.SH NAME
 
5
lynx \- a general purpose distributed information browser for the World Wide Web
 
6
.SH SYNOPSIS
 
7
.B lynx
 
8
[options] [path or URL]
 
9
.PP
 
10
use "lynx -help" to display a complete list of current options.
 
11
.SH DESCRIPTION
 
12
.\" This defines appropriate quote strings for nroff and troff
 
13
.ds lq \&"
 
14
.ds rq \&"
 
15
.if t .ds lq ``
 
16
.if t .ds rq ''
 
17
.\" Just in case these number registers aren't set yet...
 
18
.if \nN==0 .nr N 10
 
19
.if \nD==0 .nr D 5
 
20
.hy 0
 
21
.I
 
22
Lynx
 
23
is a fully-featured World Wide Web (WWW) client for users
 
24
running cursor-addressable, character-cell display devices (e.g.,
 
25
vt100 terminals, vt100 emulators running on Windows 95/NT or Macintoshes, or any
 
26
other "curses-oriented" display).  It will display hypertext
 
27
markup language (HTML) documents containing links to
 
28
files residing on the local system, as well as files residing on
 
29
remote systems running Gopher, HTTP, FTP, WAIS, and NNTP servers.
 
30
Current versions of
 
31
.I
 
32
Lynx
 
33
run on
 
34
Unix, VMS, Windows 95/NT, 386DOS and OS/2 EMX.
 
35
.PP
 
36
.I
 
37
Lynx
 
38
can be used to access information on the World Wide Web, or
 
39
to build information systems intended primarily for local access.
 
40
For example,
 
41
.I
 
42
Lynx
 
43
has been used to build several Campus Wide
 
44
Information Systems (CWIS).  In addition,
 
45
.I
 
46
Lynx
 
47
can be used to
 
48
build systems isolated within a single LAN.
 
49
.SH OPTIONS
 
50
At start up, \fILynx\fR will load any local
 
51
file or remote URL specified at the command
 
52
line.  For help with URLs, press \fB"?"\fR
 
53
or \fB"H"\fR while running \fILynx\fR.
 
54
Then follow the link titled, "Help on URLs."
 
55
 
 
56
\fILynx\fR uses only long option names. Option
 
57
names can begin with double dash as well,
 
58
underscores and dashes can be intermixed in
 
59
option names (in the reference below options
 
60
are with one dash before them and with underscores).
 
61
.PP
 
62
.TP
 
63
.B \-
 
64
If the argument is only '-', then Lynx expects to receive
 
65
the arguments from stdin.  This is to allow for the
 
66
potentially very long command line that can be associated
 
67
with the \fB\-get_data\fR or \fB\-post_data\fR arguments (see below).
 
68
It can also be used to avoid having sensitive information
 
69
in the invoking command line (which would be visible to
 
70
other processes on most systems), especially when
 
71
the \fB\-auth\fR or \fB\-pauth\fR options are used.
 
72
.TP
 
73
.B \-accept_all_cookies
 
74
accept all cookies.
 
75
.TP
 
76
.B \-anonymous
 
77
apply restrictions for anonymous account, see also \fB\-restrictions\fR.
 
78
.TP
 
79
.B \-assume_charset\fR=\fIMIMEname
 
80
charset for documents that don't specify it.
 
81
.TP
 
82
.B \-assume_local_charset\fR=\fIMIMEname
 
83
charset assumed for local files.
 
84
.TP
 
85
.B \-assume_unrec_charset\fR=\fIMIMEname
 
86
use this instead of unrecognized charsets.
 
87
.TP
 
88
.B \-auth\fR=\fIID\fR:\fIPASSWD
 
89
set authorization ID and password for protected documents
 
90
at startup.  Be sure to protect any script files which use
 
91
this switch.
 
92
.TP
 
93
.B \-base
 
94
prepend a request URL comment and BASE tag to text/html
 
95
outputs for \fB\-source\fR dumps.
 
96
.TP
 
97
.B \-bibp\fR=\fIURL
 
98
specify a local bibp server (default http://bibhost/).
 
99
.TP
 
100
.B \-blink
 
101
forces high intensity background colors for color mode, if available
 
102
and supported by the terminal.
 
103
This applies to the \fBslang\fR library (for a few terminal emulators),
 
104
or to OS/2 EMX with \fBncurses\fR.
 
105
.TP
 
106
.B \-book
 
107
use the bookmark page as the startfile.  The default or command
 
108
line startfile is still set for the Main screen command, and will
 
109
be used if the bookmark page is unavailable or blank.
 
110
.TP
 
111
.B \-buried_news
 
112
toggles scanning of news articles for buried references, and
 
113
converts them to news links.  Not recommended because email
 
114
addresses enclosed in angle brackets will be converted to
 
115
false news links, and uuencoded messages can be trashed.
 
116
.TP
 
117
.B \-cache\fR=\fINUMBER
 
118
set the NUMBER of documents cached in memory.
 
119
The default is 10.
 
120
.TP
 
121
.B \-case
 
122
enable case-sensitive string searching.
 
123
.TP
 
124
.B \-center
 
125
Toggle center alignment in HTML TABLE.
 
126
.TP
 
127
.B \-cfg\fR=\fIFILENAME
 
128
specifies a Lynx configuration file other than the default
 
129
lynx.cfg.
 
130
.TP
 
131
.B \-child
 
132
exit on left-arrow in startfile, and disable save to disk.
 
133
.TP
 
134
.B \-cmd_log\fR=\fIFILENAME
 
135
write keystroke commands and related information to the specified file.
 
136
.TP
 
137
.B \-cmd_script\fR=\fIFILENAME
 
138
read keystroke commands from the specified file.
 
139
You can use the data written using the \fB\-cmd_log\fR option.
 
140
Lynx will ignore other information which the command-logging may have
 
141
written to the logfile.
 
142
Each line of the command script contains either a comment beginning with "#",
 
143
or a keyword:
 
144
.RS 5
 
145
.TP 5
 
146
exit
 
147
causes the script to stop, and forces lynx to exit immediately.
 
148
.TP 5
 
149
key
 
150
the character value, in printable form.
 
151
Cursor and other special keys are given as names, e.g., "Down Arrow".
 
152
Printable 7-bit ASCII codes are given as-is,
 
153
and hexadecimal values represent other 8-bit codes.
 
154
.TP 5
 
155
set
 
156
followed by a "name=value" allows one to override values set in the
 
157
lynx.cfg file.
 
158
.RE
 
159
.TP
 
160
.B \-color
 
161
forces color mode on, if available.  Default color control sequences
 
162
which work for many terminal types are assumed if the terminal
 
163
capability description does not specify how to handle color.
 
164
Lynx needs to be compiled with the \fBslang\fR library for this flag,
 
165
it is equivalent to setting the \fBCOLORTERM\fR environment variable.
 
166
(If color support is instead provided by a color-capable curses
 
167
library like \fBncurses\fR, Lynx relies completely on the terminal
 
168
description to determine whether color mode is possible, and
 
169
this flag is not needed and thus unavailable.)
 
170
A saved show_color=always setting found in a .lynxrc file at
 
171
startup has the same effect.  A saved show_color=never found
 
172
in .lynxrc on startup is overridden by this flag.
 
173
.TP
 
174
.B \-connect_timeout\fR=\fIN
 
175
Sets the connection timeout, where N is given in seconds.
 
176
.TP
 
177
.B \-cookie_file\fR=\fIFILENAME
 
178
specifies a file to use to read cookies.
 
179
If none is specified, the default value is ~/.lynx_cookies
 
180
for most systems, but ~/cookies for MS-DOS.
 
181
.TP
 
182
.B \-cookie_save_file\fR=\fIFILENAME
 
183
specifies a file to use to store cookies.
 
184
If none is specified, the value given by
 
185
\fB-cookie_file\fR is used.
 
186
.TP
 
187
.B \-cookies
 
188
toggles handling of Set-Cookie headers.
 
189
.TP
 
190
.B \-core
 
191
toggles forced core dumps on fatal errors.
 
192
Turn this option off to ask lynx to force a core dump if a fatal error occurs.
 
193
.TP
 
194
.B \-crawl
 
195
with \fB\-traversal,\fR output each page to a file.
 
196
with \fB\-dump\fR, format output as with \fB\-traversal\fR, but to stdout.
 
197
.TP
 
198
.B \-curses_pads
 
199
toggles the use of curses "pad" feature which supports
 
200
left/right scrolling of the display.
 
201
.TP
 
202
.B \-debug_partial
 
203
separate incremental display stages with MessageSecs delay
 
204
.TP
 
205
.B \-delay
 
206
add DebugSecs delay after each progress-message
 
207
.TP
 
208
.B \-display\fR=\fIDISPLAY
 
209
set the display variable for X rexec-ed programs.
 
210
.TP
 
211
.B \-display_charset\fR=\fIMIMEname
 
212
set the charset for the terminal output.
 
213
.TP
 
214
.B \-dont_wrap_pre
 
215
inhibit wrapping of text in <pre> when \fB\-dump\fR'ing and \fB\-crawl\fR'ing,
 
216
mark wrapped lines in interactive session.
 
217
.TP
 
218
.B \-dump
 
219
dumps the formatted output of the default document or one
 
220
specified on the command line to standard output.
 
221
This can be used in the following way:
 
222
.sp
 
223
lynx \fB\-dump\fR http://www.subir.com/lynx.html
 
224
.TP
 
225
.B \-editor\fR=\fIEDITOR
 
226
enable external editing, using the specified
 
227
EDITOR. (vi, ed, emacs, etc.)
 
228
.TP
 
229
.B \-emacskeys
 
230
enable emacs-like key movement.
 
231
.TP
 
232
.B \-enable_scrollback
 
233
toggles compatibility with communication programs' scrollback keys
 
234
(may be incompatible with some curses packages).
 
235
.TP
 
236
.B \-error_file\fR=\fIFILE
 
237
define a file where Lynx will report HTTP access codes.
 
238
.TP
 
239
.B \-exec
 
240
enable local program execution (normally not configured).
 
241
.TP
 
242
.B \-fileversions
 
243
include all versions of files in local VMS directory listings.
 
244
.TP
 
245
.B \-find_leaks
 
246
toggle memory leak-checking.
 
247
Normally this
 
248
is not compiled-into your executable, but when it is,
 
249
it can be disabled for a session.
 
250
.TP
 
251
.B \-force_empty_hrefless_a
 
252
force HREF-less 'A' elements to be empty (close them as soon as they are seen).
 
253
.TP
 
254
.B \-force_html
 
255
forces the first document to be interpreted as HTML.
 
256
.TP
 
257
.B \-force_secure
 
258
toggles forcing of the secure flag for SSL cookies.
 
259
.TP
 
260
.B \-forms_options
 
261
toggles whether the Options Menu is key-based or form-based.
 
262
.TP
 
263
.B \-from
 
264
toggles transmissions of From headers.
 
265
.TP
 
266
.B \-ftp
 
267
disable ftp access.
 
268
.TP
 
269
.B \-get_data
 
270
properly formatted data for a get form are read in from
 
271
stdin and passed to the form.
 
272
Input is terminated by a line that starts with '---'.
 
273
.TP
 
274
.B \-head
 
275
send a HEAD request for the mime headers.
 
276
.TP
 
277
.B \-help
 
278
print the Lynx command syntax usage message.
 
279
.TP
 
280
.B \-hiddenlinks=[option]
 
281
control the display of hidden links.
 
282
 
 
283
.I merge
 
284
hidden links show up as bracketed numbers
 
285
and are numbered together with other links in the sequence of their
 
286
occurrence in the document.
 
287
 
 
288
.I listonly
 
289
hidden links are shown only on L)ist screens and listings generated by
 
290
.I \-dump
 
291
or from the P)rint menu, but appear separately at the end of those lists.
 
292
This is the default behavior.
 
293
 
 
294
.I ignore
 
295
hidden links do not appear even in listings.
 
296
.TP
 
297
.B \-historical
 
298
toggles use of '>' or '-->' as a terminator for comments.
 
299
.TP
 
300
.B \-homepage\fR=\fIURL
 
301
set homepage separate from start page.
 
302
.TP
 
303
.B \-image_links
 
304
toggles inclusion of links for all images.
 
305
.TP
 
306
.B \-index\fR=\fIURL
 
307
set the default index file to the specified URL.
 
308
.TP
 
309
.B \-ismap
 
310
toggles inclusion of ISMAP links when client-side
 
311
MAPs are present.
 
312
.TP
 
313
.B \-justify
 
314
do justification of text.
 
315
.TP
 
316
.B \-link\fR=\fINUMBER
 
317
starting count for lnk#.dat files produced by \fB\-crawl\fR.
 
318
.TP
 
319
.B \-localhost
 
320
disable URLs that point to remote hosts.
 
321
.TP
 
322
.B \-locexec
 
323
enable local program execution from local files only (if
 
324
Lynx was compiled with local execution enabled).
 
325
.TP
 
326
.B \-lss\fR=\fIFILENAME
 
327
specify filename containing color-style information.
 
328
The default is lynx.lss.
 
329
.TP
 
330
.B \-mime_header
 
331
prints the MIME header of a fetched document along with its
 
332
source.
 
333
.TP
 
334
.B \-minimal
 
335
toggles minimal versus valid comment parsing.
 
336
.TP
 
337
.B \-nested_tables
 
338
toggles nested-tables logic (for debugging).
 
339
.TP
 
340
.B \-newschunksize\fR=\fINUMBER
 
341
number of articles in chunked news listings.
 
342
.TP
 
343
.B \-newsmaxchunk\fR=\fINUMBER
 
344
maximum news articles in listings before chunking.
 
345
.TP
 
346
.B \-nobold
 
347
disable bold video-attribute.
 
348
.TP
 
349
.B \-nobrowse
 
350
disable directory browsing.
 
351
.TP
 
352
.B \-nocc
 
353
disable Cc: prompts for self copies of mailings.  Note
 
354
that this does not disable any CCs which are incorporated
 
355
within a mailto URL or form ACTION.
 
356
.TP
 
357
.B \-nocolor
 
358
force color mode off, overriding terminal capabilities and any
 
359
-color flags, COLORTERM variable, and saved .lynxrc settings.
 
360
.TP
 
361
.B \-noexec
 
362
disable local program execution. (DEFAULT)
 
363
.TP
 
364
.B \-nofilereferer
 
365
disable transmissions of Referer headers for file URLs.
 
366
.TP
 
367
.B \-nolist
 
368
disable the link list feature in dumps.
 
369
.TP
 
370
.B \-nolog
 
371
disable mailing of error messages to document owners.
 
372
.TP
 
373
.B \-nonrestarting_sigwinch
 
374
This flag is not available on all systems,
 
375
Lynx needs to be compiled with HAVE_SIGACTION defined.
 
376
If available, this flag \fImay\fR cause Lynx to react
 
377
more immediately to window changes when run within
 
378
an \fBxterm\fR.
 
379
.TP
 
380
.B \-nopause
 
381
disable forced pauses for statusline messages.
 
382
.TP
 
383
.B \-noprint
 
384
disable most print functions.
 
385
.TP
 
386
.B \-noredir
 
387
prevents automatic redirection and prints a message with a
 
388
link to the new URL.
 
389
.TP
 
390
.B \-noreferer
 
391
disable transmissions of Referer headers.
 
392
.TP
 
393
.B \-noreverse
 
394
disable reverse video-attribute.
 
395
.TP
 
396
.B \-nosocks
 
397
disable SOCKS proxy usage by a SOCKSified Lynx.
 
398
.TP
 
399
.B \-nostatus
 
400
disable the retrieval status messages.
 
401
.TP
 
402
.B \-nounderline
 
403
disable underline video-attribute.
 
404
.TP
 
405
.B \-number_fields
 
406
force numbering of links as well as form input fields
 
407
.TP
 
408
.B \-number_links
 
409
force numbering of links.
 
410
.TP
 
411
.B \-partial
 
412
toggles display partial pages while loading.
 
413
.TP
 
414
.B \-partial_thres\fR=\fINUMBER
 
415
number of lines to render before repainting display
 
416
with partial-display logic
 
417
.TP
 
418
.B \-pauth\fR=\fIID\fR:\fIPASSWD
 
419
set authorization ID and password for a protected proxy
 
420
server at startup.  Be sure to protect any script files
 
421
which use this switch.
 
422
.TP
 
423
.B \-popup
 
424
toggles handling of single-choice SELECT options via
 
425
popup windows or as lists of radio buttons.
 
426
.TP
 
427
.B \-post_data
 
428
properly formatted data for a post form are read in from 
 
429
stdin and passed to the form.
 
430
Input is terminated by a line that starts with '---'. 
 
431
.TP
 
432
.B \-preparsed
 
433
show HTML source preparsed and reformatted when used with \fB\-source\fR
 
434
or in source view.
 
435
.TP
 
436
.B \-prettysrc
 
437
show HTML source view with lexical elements and tags in color.
 
438
.TP
 
439
.B \-print
 
440
enable print functions. (default)
 
441
.TP
 
442
.B \-pseudo_inlines
 
443
toggles pseudo-ALTs for inlines with no ALT string.
 
444
.TP
 
445
.B \-raw
 
446
toggles default setting of 8-bit character translations
 
447
or CJK mode for the startup character set.
 
448
.TP
 
449
.B \-realm
 
450
restricts access to URLs in the starting realm.
 
451
.TP
 
452
.B \-reload
 
453
flushes the cache on a proxy server
 
454
(only the first document affected).
 
455
.TP
 
456
.B \-restrictions\fR=\fI[option][,option][,option]...
 
457
allows a list of services to be disabled
 
458
selectively. Dashes and underscores in option names
 
459
can be intermixed. The following list is printed
 
460
if no options are specified.
 
461
 
 
462
.I all
 
463
- restricts all options listed below.
 
464
 
 
465
.I bookmark
 
466
- disallow changing the location of the bookmark
 
467
file.
 
468
 
 
469
.I bookmark_exec
 
470
- disallow execution links via the bookmark file.
 
471
 
 
472
.I change_exec_perms
 
473
- disallow changing the eXecute permission on files
 
474
(but still allow it for directories) when local file
 
475
management is enabled.
 
476
 
 
477
.I default
 
478
- same as command line option \fB\-anonymous\fR.
 
479
Disables default services for anonymous users.
 
480
Set to all restricted, except for:
 
481
inside_telnet, outside_telnet,
 
482
inside_ftp, outside_ftp,
 
483
inside_rlogin, outside_rlogin,
 
484
inside_news, outside_news, telnet_port,
 
485
jump, mail, print, exec, and goto.
 
486
The settings for these,
 
487
as well as additional goto restrictions for
 
488
specific URL schemes that are also applied,
 
489
are derived from definitions within userdefs.h.
 
490
 
 
491
.I dired_support
 
492
- disallow local file management.
 
493
 
 
494
.I disk_save
 
495
- disallow saving to disk in the download and
 
496
print menus.
 
497
 
 
498
.I dotfiles
 
499
- disallow access to, or creation of, hidden (dot) files.
 
500
 
 
501
.I download
 
502
- disallow some downloaders in the download menu (does not
 
503
imply disk_save restriction).
 
504
 
 
505
.I editor
 
506
- disallow external editing.
 
507
 
 
508
.I exec
 
509
- disable execution scripts.
 
510
 
 
511
.I exec_frozen
 
512
- disallow the user from changing the local
 
513
execution option.
 
514
 
 
515
.I externals
 
516
- disallow some "EXTERNAL" configuration lines
 
517
if support for passing URLs to external
 
518
applications (with the EXTERN command) is
 
519
compiled in.
 
520
 
 
521
.I file_url
 
522
- disallow using G)oto, served links or bookmarks for
 
523
file: URLs.
 
524
 
 
525
.I goto
 
526
- disable the 'g' (goto) command.
 
527
 
 
528
.I inside_ftp
 
529
- disallow ftps for people coming from inside your
 
530
domain (utmp required for selectivity).
 
531
 
 
532
.I inside_news
 
533
- disallow USENET news posting for people coming
 
534
from inside your domain (utmp required for selectivity).
 
535
 
 
536
.I inside_rlogin
 
537
- disallow rlogins for people coming from inside
 
538
your domain (utmp required for selectivity).
 
539
 
 
540
.I inside_telnet
 
541
- disallow telnets for people coming from inside
 
542
your domain (utmp required for selectivity).
 
543
 
 
544
.I jump
 
545
- disable the 'j' (jump) command.
 
546
 
 
547
.I multibook
 
548
- disallow multiple bookmarks.
 
549
 
 
550
.I mail
 
551
- disallow mail.
 
552
 
 
553
.I news_post
 
554
- disallow USENET News posting.
 
555
 
 
556
.I options_save
 
557
- disallow saving options in .lynxrc.
 
558
 
 
559
.I outside_ftp
 
560
- disallow ftps for people coming from outside your
 
561
domain (utmp required for selectivity).
 
562
 
 
563
.I outside_news
 
564
- disallow USENET news reading and posting for people coming
 
565
from outside your domain (utmp required for selectivity).
 
566
This restriction applies to "news", "nntp", "newspost", and
 
567
"newsreply" URLs, but not to "snews", "snewspost",
 
568
or "snewsreply" in case they are supported.
 
569
 
 
570
.I outside_rlogin
 
571
- disallow rlogins for people coming from outside
 
572
your domain (utmp required for selectivity).
 
573
 
 
574
.I outside_telnet
 
575
- disallow telnets for people coming from
 
576
outside your domain (utmp required for selectivity).
 
577
 
 
578
.I print
 
579
- disallow most print options.
 
580
 
 
581
.I shell
 
582
- disallow shell escapes and lynxexec or lynxprog G)oto's.
 
583
 
 
584
.I suspend
 
585
- disallow Unix Control-Z suspends with escape to shell.
 
586
 
 
587
.I telnet_port
 
588
- disallow specifying a port in telnet G)oto's.
 
589
 
 
590
.I useragent
 
591
- disallow modifications of the User-Agent header.
 
592
 
 
593
.TP
 
594
.B \-resubmit_posts
 
595
toggles forced resubmissions (no-cache) of forms with
 
596
method POST when the documents they returned are sought
 
597
with the PREV_DOC command or from the History List.
 
598
.TP
 
599
.B \-rlogin
 
600
disable recognition of rlogin commands.
 
601
.TP
 
602
.B \-scrollbar
 
603
toggles showing scrollbar.
 
604
.TP
 
605
.B \-scrollbar_arrow
 
606
toggles showing arrows at ends of the scrollbar.
 
607
.TP
 
608
.B \-selective
 
609
require .www_browsable files to browse directories.
 
610
.TP
 
611
.B \-short_url
 
612
show very long URLs in the status line with "..." to represent the
 
613
portion which cannot be displayed.
 
614
The beginning and end of the URL are displayed, rather than suppressing the end.
 
615
.TP
 
616
.B \-show_cursor
 
617
If enabled the cursor will not be hidden in the right hand
 
618
corner but will instead be positioned at the start of the
 
619
currently selected link.  Show cursor is the default for
 
620
systems without FANCY_CURSES capabilities.  The default
 
621
configuration can be changed in userdefs.h or lynx.cfg.
 
622
The command line switch toggles the default.
 
623
.TP
 
624
.B \-show_rate
 
625
If enabled the transfer rate is shown in bytes/second.
 
626
If disabled, no transfer rate is shown.
 
627
Use lynx.cfg or the options menu to select KB/second and/or ETA.
 
628
.TP
 
629
.B \-soft_dquotes
 
630
toggles emulation of the old Netscape and Mosaic bug which
 
631
treated '>' as a co-terminator for double-quotes and tags.
 
632
.TP
 
633
.B \-source
 
634
works the same as dump but outputs HTML source instead of
 
635
formatted text.
 
636
.TP
 
637
.B \-stack_dump
 
638
disable SIGINT cleanup handler
 
639
.TP
 
640
.B \-startfile_ok
 
641
allow non-http startfile and homepage with \fB\-validate\fR.
 
642
.TP
 
643
.B \-stdin
 
644
read the startfile from standard input
 
645
(UNIX only).
 
646
.TP
 
647
.B \-syslog\fR=\fItext
 
648
information for syslog call.
 
649
.TP
 
650
.B \-tagsoup
 
651
initialize parser, using Tag Soup DTD rather than SortaSGML.
 
652
.TP
 
653
.B \-telnet
 
654
disable recognition of telnet commands.
 
655
.TP
 
656
.B \-term\fR=\fITERM
 
657
tell Lynx what terminal type to assume it is talking to.
 
658
(This may be useful for remote execution, when, for example,
 
659
Lynx connects to a remote TCP/IP port that starts a script that,
 
660
in turn, starts another Lynx process.)
 
661
.TP
 
662
.B \-timeout\fR=\fIN
 
663
For win32, sets the network read-timeout, where N is given in seconds.
 
664
.TP
 
665
.B \-tlog
 
666
toggles between using a Lynx Trace Log and stderr for trace output
 
667
from the session.
 
668
.TP
 
669
.B \-tna
 
670
turns on "Textfields Need Activation" mode.
 
671
.TP
 
672
.B \-trace
 
673
turns on Lynx trace mode.  Destination of trace output depends
 
674
on \-tlog.
 
675
.TP
 
676
.B \-trace_mask\fR=\fIvalue
 
677
turn on optional traces, which may result in very large trace files.
 
678
Logically OR the values to combine options:
 
679
.br
 
680
1=SGML character parsing states
 
681
.br
 
682
2=color-style
 
683
.br
 
684
4=TRST (table layout)
 
685
.br
 
686
8=config (lynx.cfg and .lynxrc contents)
 
687
.br
 
688
16=binary string copy/append, used in form data construction.
 
689
.TP
 
690
.B \-traversal
 
691
traverse all http links derived from startfile.  When used with
 
692
-crawl, each link that begins with the same string as startfile
 
693
is output to a file, intended for indexing.  See CRAWL.announce
 
694
for more information.
 
695
.TP
 
696
.B trim_input_fields
 
697
trim input text/textarea fields in forms.
 
698
.TP
 
699
.B \-underline_links
 
700
toggles use of underline/bold attribute for links.
 
701
.TP
 
702
.B \-underscore
 
703
toggles use of _underline_ format in dumps.
 
704
.TP
 
705
.B \-use_mouse
 
706
turn on mouse support, if available.
 
707
Clicking the left mouse button on a link traverses it.
 
708
Clicking the right mouse button pops back.
 
709
Click on the top line to scroll up.
 
710
Click on the bottom line to scroll down.
 
711
The first few positions in the top and bottom line may invoke
 
712
additional functions.
 
713
Lynx must be compiled with \fBncurses\fR or \fBslang\fR to support this feature.
 
714
If \fBncurses\fR is used, clicking the middle mouse button pops up
 
715
a simple menu.  Mouse clicks may only work reliably while Lynx is
 
716
idle waiting for input.
 
717
.TP
 
718
.B \-useragent=Name
 
719
set alternate Lynx User-Agent header.
 
720
.TP
 
721
.B \-validate
 
722
accept only http URLs (for validation).  Complete security
 
723
restrictions also are implemented.
 
724
.TP
 
725
.B \-verbose
 
726
toggle [LINK], [IMAGE] and [INLINE] comments with filenames of these images.
 
727
.TP
 
728
.B \-version
 
729
print version information.
 
730
.TP
 
731
.B \-vikeys
 
732
enable vi-like key movement.
 
733
.TP
 
734
.B \-wdebug
 
735
enable Waterloo tcp/ip packet debug (print to watt debugfile).
 
736
This applies only to DOS versions compiled with WATTCP or WATT-32.
 
737
.TP
 
738
.B \-width\fR=\fINUMBER
 
739
number of columns for formatting of dumps, default is 80.
 
740
.TP
 
741
.B \-with_backspaces
 
742
emit backspaces in output if \fB\-dump\fR'ing or \fB\-crawl\fR'ing (like 'man' does)
 
743
.SH COMMANDS
 
744
o Use \fBUp arrow\fR and \fBDown arrow\fR to scroll through hypertext links.
 
745
.br
 
746
o \fBRight arrow\fR or \fBReturn\fR will follow a highlighted hypertext link.
 
747
.br
 
748
o \fBLeft Arrow\fR will retreat from a link.
 
749
.br
 
750
o Type \fB"H"\fR or \fB"?"\fR for online help and descriptions
 
751
of key-stroke commands.
 
752
.br
 
753
o Type \fB"K"\fR for a complete list of the current key-stroke
 
754
command mappings.
 
755
.SH ENVIRONMENT
 
756
In addition to various "standard" environment variables such as
 
757
\fBHOME\fR, \fBPATH\fR, \fBUSER\fR, \fBDISPLAY\fR, \fBTMPDIR\fR, \fBetc\fR,
 
758
\fILynx\fR utilizes several Lynx-specific environment variables, if they
 
759
exist.
 
760
.PP
 
761
Others may be created or modified by \fILynx\fR to pass data to an external
 
762
program, or for other reasons.  These are listed separately below.
 
763
.PP
 
764
See also the sections on \fBSIMULATED CGI SUPPORT\fR and
 
765
\fBNATIVE LANGUAGE SUPPORT\fR, below.
 
766
.PP
 
767
Note:  Not all environment variables apply to all types of platforms
 
768
supported by \fILynx\fR, though most do.  Feedback on platform
 
769
dependencies is solicited.
 
770
.PP
 
771
Environment Variables Used By \fILynx\fR:
 
772
.TP 20
 
773
.B COLORTERM
 
774
If set, color capability for the terminal is forced on at startup time.
 
775
The actual value assigned to the variable is ignored.  This variable is
 
776
only meaningful if \fILynx\fR was built using the \fBslang\fR
 
777
screen-handling library.
 
778
.TP 20
 
779
.B LYNX_CFG
 
780
This variable, if set, will override the default location and name of
 
781
the global configuration file (normally, \fBlynx.cfg\fR) that was defined
 
782
by the LYNX_CFG_FILE constant in the userdefs.h file, during installation.
 
783
See the userdefs.h file for more information.
 
784
.TP 20
 
785
.B LYNX_LOCALEDIR
 
786
If set, this variable overrides the compiled-in location of the
 
787
locale directory which contains native language (NLS) message text.
 
788
.TP 20
 
789
.B LYNX_LSS
 
790
This variable, if set, specifies the location of the default \fILynx\fR
 
791
character style sheet file.  [Currently only meaningful if \fILynx\fR was
 
792
built using experimental color style support.]
 
793
.TP 20
 
794
.B LYNX_SAVE_SPACE
 
795
This variable, if set, will override the default path prefix for files
 
796
saved to disk that is defined in the \fBlynx.cfg SAVE_SPACE:\fR statement.
 
797
See the \fBlynx.cfg\fR file for more information.
 
798
.TP 20
 
799
.B LYNX_TEMP_SPACE
 
800
This variable, if set, will override the default path prefix for temporary
 
801
files that was defined during installation, as well as any value that may
 
802
be assigned to the \fBTMPDIR\fR variable.
 
803
.TP 20
 
804
.B MAIL
 
805
This variable specifies the default inbox \fILynx\fR will check for new
 
806
mail, if such checking is enabled in the \fBlynx.cfg\fR file.
 
807
.TP 20
 
808
.B NEWS_ORGANIZATION
 
809
This variable, if set, provides the string used in the \fBOrganization:\fR
 
810
header of \fBUSENET\fR news postings.  It will override the setting of the
 
811
ORGANIZATION environment variable, if it is also set (and, on \fBUNIX\fR,
 
812
the contents of an /etc/organization file, if present).
 
813
.TP 20
 
814
.B NNTPSERVER
 
815
If set, this variable specifies the default NNTP server that will be used
 
816
for \fBUSENET\fR news reading and posting with \fILynx\fR, via news: URL's.
 
817
.TP 20
 
818
.B ORGANIZATION
 
819
This variable, if set, provides the string used in the \fBOrganization:\fR
 
820
header of \fBUSENET\fR news postings.  On \fBUNIX\fR, it will override the
 
821
contents of an /etc/organization file, if present.
 
822
.TP 20
 
823
.B PROTOCOL_proxy
 
824
\fILynx\fR supports the use of proxy servers that can act as firewall
 
825
gateways and caching servers.  They are preferable to the older gateway
 
826
servers (see WWW_access_GATEWAY, below).  Each protocol used by \fILynx\fR,
 
827
(http, ftp, gopher, etc), can be mapped separately by setting environment
 
828
variables of the form PROTOCOL_proxy (literally: http_proxy, ftp_proxy,
 
829
gopher_proxy, etc), to "http://some.server.dom:port/".
 
830
See \fBLynx Users Guide\fR for additional details and examples.
 
831
.TP 20
 
832
.B SSL_CERT_DIR
 
833
Set to the directory containing trusted certificates.
 
834
.TP 20
 
835
.B SSL_CERT_FILE
 
836
Set to the full path and filename for your file of trusted certificates.
 
837
.TP 20
 
838
.B WWW_access_GATEWAY
 
839
\fILynx\fR still supports use of gateway servers, with the servers specified
 
840
via "WWW_access_GATEWAY" variables (where "access" is lower case and can be
 
841
"http", "ftp", "gopher" or "wais"), however most gateway servers have been
 
842
discontinued.  Note that you do not include a terminal '/' for gateways, but
 
843
do for proxies specified by PROTOCOL_proxy environment variables.
 
844
See \fBLynx Users Guide\fR for details.
 
845
.TP 20
 
846
.B WWW_HOME
 
847
This variable, if set, will override the default startup URL specified
 
848
in any of the \fILynx\fR configuration files.
 
849
.PP
 
850
Environment Variables \fBSet\fR or \fBModified\fR By \fILynx\fR:
 
851
.TP 20
 
852
.B LYNX_PRINT_DATE
 
853
This variable is set by the \fILynx\fR p(rint) function, to the
 
854
\fBDate:\fR
 
855
string seen in the document's "\fBInformation about\fR" page (= cmd),
 
856
if any.
 
857
It is created for use by an external program, as defined in a
 
858
\fBlynx.cfg PRINTER:\fR definition statement.
 
859
If the field does not exist for the document, the variable is set to a
 
860
null string under \fBUNIX\fR, or "No Date" under \fBVMS\fR.
 
861
.TP 20
 
862
.B LYNX_PRINT_LASTMOD
 
863
This variable is set by the \fILynx\fR p(rint) function, to the
 
864
\fBLast Mod:\fR
 
865
string seen in the document's "\fBInformation about\fR" page (= cmd),
 
866
if any.
 
867
It is created for use by an external program, as defined in a
 
868
\fBlynx.cfg PRINTER:\fR definition statement.
 
869
If the field does not exist for the document, the variable is set to a
 
870
null string under \fBUNIX\fR, or "No LastMod" under \fBVMS\fR.
 
871
.TP 20
 
872
.B LYNX_PRINT_TITLE
 
873
This variable is set by the \fILynx\fR p(rint) function, to the
 
874
\fBLinkname:\fR
 
875
string seen in the document's "\fBInformation about\fR" page (= cmd),
 
876
if any.
 
877
It is created for use by an external program, as defined in a
 
878
\fBlynx.cfg PRINTER:\fR definition statement.
 
879
If the field does not exist for the document, the variable is set to a
 
880
null string under \fBUNIX\fR, or "No Title" under \fBVMS\fR.
 
881
.TP 20
 
882
.B LYNX_PRINT_URL
 
883
This variable is set by the \fILynx\fR p(rint) function, to the
 
884
\fBURL:\fR
 
885
string seen in the document's "\fBInformation about\fR" page (= cmd),
 
886
if any.
 
887
It is created for use by an external program, as defined in a
 
888
\fBlynx.cfg PRINTER:\fR definition statement.
 
889
If the field does not exist for the document, the variable is set to a
 
890
null string under \fBUNIX\fR, or "No URL" under \fBVMS\fR.
 
891
.TP 20
 
892
.B LYNX_TRACE
 
893
If set, causes \fILynx\fR to write a trace file as if the \fB-trace\fR
 
894
option were supplied. 
 
895
.TP 20
 
896
.B LYNX_TRACE_FILE
 
897
If set, overrides the compiled-in name of the trace file,
 
898
which is either Lynx.trace or LY-TRACE.LOG (the latter on the DOS platform).
 
899
The trace file is in either case relative to the home directory.
 
900
.TP 20
 
901
.B LYNX_VERSION
 
902
This variable is always set by \fILynx\fR, and may be used by an external
 
903
program to determine if it was invoked by \fILynx\fR.  See also the comments
 
904
in the distribution's sample \fBmailcap\fR file, for notes on usage in such
 
905
a file.
 
906
.TP 20
 
907
.B TERM
 
908
Normally, this variable is used by \fILynx\fR to determine the terminal type
 
909
being used to invoke \fILynx\fR.  If, however, it is unset at startup time
 
910
(or has the value "unknown"),
 
911
or if the \fB-term\fR command-line option is used (see \fBOPTIONS\fR section
 
912
above), \fILynx\fR will set or modify its value to the user specified
 
913
terminal type (for the \fILynx\fR execution environment).
 
914
Note: If set/modified by \fILynx\fR, the values of the \fBLINES\fR and/or
 
915
\fBCOLUMNS\fR environment variables may also be changed.
 
916
.SH SIMULATED CGI SUPPORT
 
917
If built with the \fBcgi-links\fR option enabled, \fILynx\fR allows access
 
918
to a cgi script directly without the need for an http daemon.
 
919
.PP
 
920
When executing such "lynxcgi scripts" (if enabled), the following variables
 
921
may be set for simulating a CGI environment:
 
922
.PP
 
923
.B CONTENT_LENGTH
 
924
.PP
 
925
.B CONTENT_TYPE
 
926
.PP
 
927
.B DOCUMENT_ROOT
 
928
.PP
 
929
.B HTTP_ACCEPT_CHARSET
 
930
.PP
 
931
.B HTTP_ACCEPT_LANGUAGE
 
932
.PP
 
933
.B HTTP_USER_AGENT
 
934
.PP
 
935
.B PATH_INFO
 
936
.PP
 
937
.B PATH_TRANSLATED
 
938
.PP
 
939
.B QUERY_STRING
 
940
.PP
 
941
.B REMOTE_ADDR
 
942
.PP
 
943
.B REMOTE_HOST
 
944
.PP
 
945
.B REQUEST_METHOD
 
946
.PP
 
947
.B SERVER_SOFTWARE
 
948
.PP
 
949
Other environment variables are not inherited by the script, unless they
 
950
are provided via a LYNXCGI_ENVIRONMENT statement in the configuration file.
 
951
See the \fBlynx.cfg\fR file, and the (draft) CGI 1.1 Specification
 
952
<http://Web.Golux.Com/coar/cgi/draft-coar-cgi-v11-00.txt> for the
 
953
definition and usage of these variables.
 
954
.PP
 
955
The CGI Specification, and other associated documentation, should be consulted
 
956
for general information on CGI script programming.
 
957
.SH NATIVE LANGUAGE SUPPORT
 
958
If configured and installed with \fBNative Language Support\fR, \fILynx\fR
 
959
will display status and other messages in your local language.  See the
 
960
file \fBABOUT_NLS\fR in the source distribution, or at your local \fBGNU\fR
 
961
site, for more information about internationalization.
 
962
.PP
 
963
The following environment variables may be used to alter default settings:
 
964
.TP 20
 
965
.B LANG
 
966
This variable, if set, will override the default message language.  It
 
967
is an \fBISO 639\fR two-letter code identifying the language.  Language
 
968
codes are \fBNOT\fR the same as the country codes given in \fBISO 3166\fR.
 
969
.TP 20
 
970
.B LANGUAGE
 
971
This variable, if set, will override the default message language.
 
972
This is a \fBGNU\fR extension that has higher priority for setting
 
973
the message catalog than \fBLANG\fR or \fBLC_ALL\fR.
 
974
.TP 20
 
975
.B LC_ALL
 
976
and
 
977
.TP 20
 
978
.B LC_MESSAGES
 
979
These variables, if set, specify the notion of native language
 
980
formatting style.  They are \fBPOSIXly\fR correct.
 
981
.TP 20
 
982
.B LINGUAS
 
983
This variable, if set prior to configuration, limits the installed
 
984
languages to specific values.  It is a space-separated list of two-letter
 
985
codes.  Currently, it is hard-coded to a wish list.
 
986
.TP 20
 
987
.B NLSPATH
 
988
This variable, if set, is used as the path prefix for message catalogs.
 
989
.SH NOTES
 
990
This is the Lynx v2.8.4 Release
 
991
.PP
 
992
If you wish to contribute to the further development
 
993
of \fILynx\fR, subscribe to our mailing list.  Send email to
 
994
<majordomo@sig.net> with "subscribe lynx-dev" as the only line
 
995
in the body of your message.
 
996
.PP
 
997
Send bug reports, comments, suggestions to <lynx-dev@sig.net>
 
998
after subscribing.
 
999
.PP
 
1000
Unsubscribe by sending email to <majordomo@sig.net> with
 
1001
"unsubscribe lynx-dev" as the only line in the body of your message.
 
1002
Do not send the unsubscribe message to the lynx-dev list, itself.
 
1003
.SH SEE ALSO
 
1004
.hy 0
 
1005
\fIcatgets\fR(3),
 
1006
\fIcurses\fR(3),
 
1007
\fIenviron\fR(7),
 
1008
\fIexecve\fR(2),
 
1009
\fIftp\fR(1),
 
1010
\fIgettext\fR(GNU),
 
1011
\fIlocaleconv\fR(3),
 
1012
\fIncurses\fR(3),
 
1013
\fIsetlocale\fR(3),
 
1014
\fIslang\fR(?),
 
1015
\fItermcap\fR(5),
 
1016
\fIterminfo\fR(5),
 
1017
\fIwget\fR(GNU)
 
1018
.hy 1
 
1019
.PP
 
1020
Note that man page availability and section numbering is somewhat
 
1021
platform dependent, and may vary from the above references.
 
1022
.PP
 
1023
A section shown as (GNU), is intended to denote that the topic
 
1024
may be available via an info page, instead of a man page (i.e., try
 
1025
"info subject", rather than "man subject").
 
1026
.PP
 
1027
A section shown as (?) denotes that documentation on the topic exists,
 
1028
but is not part of an established documentation retrieval system (see
 
1029
the distribution files associated with the topic, or contact your
 
1030
System Administrator for further information).
 
1031
.SH ACKNOWLEDGMENTS
 
1032
Lynx has incorporated code from a variety of sources along the way.
 
1033
The earliest versions of Lynx included code from Earl Fogel of Computing
 
1034
Services at the University of Saskatchewan, who implemented HYPERREZ
 
1035
in the Unix environment.  HYPERREZ was developed by Niel Larson of
 
1036
Think.com and served as the model for the early versions of Lynx.
 
1037
Those versions also incorporated libraries from the Unix Gopher clients
 
1038
developed at the University of Minnesota, and the later versions of
 
1039
Lynx rely on the WWW client library code developed by Tim Berners-Lee
 
1040
and the WWW community.  Also a special thanks to Foteos Macrides who ported
 
1041
much of Lynx to VMS and did or organized most of its development since the
 
1042
departures of Lou Montulli and Garrett Blythe from the University of Kansas
 
1043
in the summer of 1994 through the release of v2.7.2, and to everyone
 
1044
on the net who has contributed to Lynx's development either directly (through
 
1045
patches, comments or bug reports) or indirectly (through inspiration and
 
1046
development of other systems).
 
1047
.SH AUTHORS
 
1048
Lou Montulli, Garrett Blythe, Craig Lavender, Michael Grobe, Charles Rezac
 
1049
.br
 
1050
Academic Computing Services
 
1051
.br
 
1052
University of Kansas
 
1053
.br
 
1054
Lawrence, Kansas 66047
 
1055
.PP
 
1056
Foteos Macrides
 
1057
.br
 
1058
Worcester Foundation for Biomedical Research
 
1059
.br
 
1060
Shrewsbury, Massachusetts 01545