Penguin
Recent Changes
Annotated edit history of lynx(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 LYNX
2 !!!LYNX
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 COMMANDS
8 ENVIRONMENT
9 SIMULATED CGI SUPPORT
10 NATIVE LANGUAGE SUPPORT
11 NOTES
12 SEE ALSO
13 ACKNOWLEDGMENTS
14 AUTHORS
15 ----
16 !!NAME
17
18
19 lynx - a general purpose distributed information browser for the World Wide Web
20 !!SYNOPSIS
21
22
23 __lynx__ [[options] [[path or URL]
24
25
26 use
27 !!DESCRIPTION
28
29
30 ''Lynx'' is a fully-featured World Wide Web (WWW) client
31 for users running cursor-addressable, character-cell display
32 devices (e.g., vt100 terminals, vt100 emulators running on
33 Windows 95/NT or Macintoshes, or any other
34 ''Lynx'' run on
35 Unix, VMS, Windows 95/NT, 386DOS and OS/2 EMX.
36
37
38 ''Lynx'' can be used to access information on the World
39 Wide Web, or to build information systems intended primarily
40 for local access. For example, ''Lynx'' has been used to
41 build several Campus Wide Information Systems (CWIS). In
42 addition, ''Lynx'' can be used to build systems isolated
43 within a single LAN.
44 !!OPTIONS
45
46
47 At start up, ''Lynx'' will load any local file or remote
48 URL specified at the command line. For help with URLs, press
49 ____ or ____ while running
50 ''Lynx''. Then follow the link titled,
51 ''
52
53
54 ''Lynx'' uses only long option names. Option names can
55 begin with double dash as well, underscores and dashes can
56 be intermixed in option names (in the reference below
57 options are with one dash before them and with
58 underscores).
59
60
61 __-__
62
63
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 -get_data or -post_data arguments (see below). It
68 can also be used to avoid having sensitive information in
69 the invoking command line (which would be visible to other
70 processes on most systems), especially when the -auth or
71 -pauth options are used.
72
73
74 __-accept_all_cookies__
75
76
77 accept all cookies.
78
79
80 __-anonymous__
81
82
83 apply restrictions for anonymous account, see also
84 -restrictions.
85
86
87 __-assume_charset__=''MIMEname''
88
89
90 charset for documents that don't specify it.
91
92
93 __-assume_local_charset__=''MIMEname''
94
95
96 charset assumed for local files.
97
98
99 __-assume_unrec_charset__=''MIMEname''
100
101
102 use this instead of unrecognized charsets.
103
104
105 __-auth__=''ID'':''PASSWD''
106
107
108 set authorization ID and password for protected documents at
109 startup. Be sure to protect any script files which use this
110 switch.
111
112
113 __-base__
114
115
116 prepend a request URL comment and BASE tag to text/html
117 outputs for -source dumps.
118
119
120 __-bibp__=''URL''
121
122
123 specify a local bibp server (default
124 http://bibhost/).
125
126
127 __-blink__
128
129
130 forces high intensity background colors for color mode, if
131 available and supported by the terminal. This applies to the
132 __slang__ library (for a few terminal emulators), or to
133 OS/2 EMX with __ncurses__.
134
135
136 __-book__
137
138
139 use the bookmark page as the startfile. The default or
140 command line startfile is still set for the Main screen
141 command, and will be used if the bookmark page is
142 unavailable or blank.
143
144
145 __-buried_news__
146
147
148 toggles scanning of news articles for buried references, and
149 converts them to news links. Not recommended because email
150 addresses enclosed in angle brackets will be converted to
151 false news links, and uuencoded messages can be
152 trashed.
153
154
155 __-cache__=''NUMBER''
156
157
158 set the NUMBER of documents cached in memory. The default is
159 10.
160
161
162 __-case__
163
164
165 enable case-sensitive string searching.
166
167
168 __-center__
169
170
171 Toggle center alignment in HTML TABLE.
172
173
174 __-cfg__=''FILENAME''
175
176
177 specifies a Lynx configuration file other than the default
178 lynx.cfg.
179
180
181 __-child__
182
183
184 exit on left-arrow in startfile, and disable save to
185 disk.
186
187
188 __-cmd_log__=''FILENAME''
189
190
191 write keystroke commands and related information to the
192 specified file.
193
194
195 __-cmd_script__=''FILENAME''
196
197
198 read keystroke commands from the specified file. You can use
199 the data written using the __-cmd_log__ option. Lynx will
200 ignore other information which the command-logging may have
201 written to the logfile.
202
203
204 __-color__
205
206
207 forces color mode on, if available. Default color control
208 sequences which work for many terminal types are assumed if
209 the terminal capability description does not specify how to
210 handle color. Lynx needs to be compiled with the
211 __slang__ library for this flag, it is equivalent to
212 setting the __COLORTERM__ environment variable. (If color
213 support is instead provided by a color-capable curses
214 library like __ncurses__, Lynx relies completely on the
215 terminal description to determine whether color mode is
216 possible, and this flag is not needed and thus unavailable.)
217 A saved show_color=always setting found in a .lynxrc file at
218 startup has the same effect. A saved show_color=never found
219 in .lynxrc on startup is overridden by this
220 flag.
221
222
223 __-connect_timeout__=''N''
224
225
226 Sets the connection timeout, where N is given in seconds.
227 This is not available under DOS (use the sockdelay parameter
228 of WATTCP under DOS).
229
230
231 __-cookie_file__=''FILENAME''
232
233
234 specifies a file to use to read cookies. If none is
235 specified, the default value is ~/.lynx_cookies for most
236 systems, but ~/cookies for MS-DOS.
237
238
239 __-cookie_save_file__=''FILENAME''
240
241
242 specifies a file to use to store cookies. If none is
243 specified, the value given by __-cookie_file__ is
244 used.
245
246
247 __-cookies__
248
249
250 toggles handling of Set-Cookie headers.
251
252
253 __-core__
254
255
256 toggles forced core dumps on fatal errors.
257
258
259 __-crawl__
260
261
262 with -traversal, output each page to a file. with -dump,
263 format output as with -traversal, but to
264 stdout.
265
266
267 __-curses_pads__
268
269
270 toggles the use of curses
271
272
273 __-debug_partial__
274
275
2 perry 276 separate incremental display stages with !MessageSecs
1 perry 277 delay
278
279
280 __-display__=''DISPLAY''
281
282
283 set the display variable for X rexec-ed
284 programs.
285
286
287 __-display_charset__=''MIMEname''
288
289
290 set the charset for the terminal output.
291
292
293 __-dont_wrap_pre__
294
295
296 inhibit wrapping of text in
297
298
299 __-dump__
300
301
302 dumps the formatted output of the default document or one
303 specified on the command line to standard output. This can
304 be used in the following way:
305
306
307 lynx -dump http://www.trill-home.com/lynx.html
308
309
310 __-editor__=''EDITOR''
311
312
313 enable external editing, using the specified EDITOR. (vi,
314 ed, emacs, etc.)
315
316
317 __-emacskeys__
318
319
320 enable emacs-like key movement.
321
322
323 __-enable_scrollback__
324
325
326 toggles compatibility with communication programs'
327 scrollback keys (may be incompatible with some curses
328 packages).
329
330
331 __-error_file__=''FILE''
332
333
334 define a file where Lynx will report HTTP access
335 codes.
336
337
338 __-exec__
339
340
341 enable local program execution (normally not
342 configured).
343
344
345 __-fileversions__
346
347
348 include all versions of files in local VMS directory
349 listings.
350
351
352 __-force_empty_hrefless_a__
353
354
355 force HREF-less 'A' elements to be empty (close them as soon
356 as they are seen).
357
358
359 __-force_html__
360
361
362 forces the first document to be interpreted as
363 HTML.
364
365
366 __-force_secure__
367
368
369 toggles forcing of the secure flag for SSL
370 cookies.
371
372
373 __-forms_options__
374
375
376 toggles whether the Options Menu is key-based or
377 form-based.
378
379
380 __-from__
381
382
383 toggles transmissions of From headers.
384
385
386 __-ftp__
387
388
389 disable ftp access.
390
391
392 __-get_data__
393
394
395 properly formatted data for a get form are read in from
396 stdin and passed to the form. Input is terminated by a line
397 that starts with '---'.
398
399
400 __-head__
401
402
403 send a HEAD request for the mime headers.
404
405
406 __-help__
407
408
409 print the Lynx command syntax usage message.
410
411
412 __-hiddenlinks=[[option]__
413
414
415 control the display of hidden links.
416
417
418 ''merge'' hidden links show up as bracketed numbers and
419 are numbered together with other links in the sequence of
420 their occurrence in the document.
421
422
423 ''listonly'' hidden links are shown only on L)ist screens
424 and listings generated by ''-dump'' or from the P)rint
425 menu, but appear separately at the end of those lists. This
426 is the default behavior.
427
428
429 ''ignore'' hidden links do not appear even in
430 listings.
431
432
433 __-historical__
434
435
436 toggles use of '
437
438
439 __-homepage__=''URL''
440
441
442 set homepage separate from start page.
443
444
445 __-image_links__
446
447
448 toggles inclusion of links for all images.
449
450
451 __-index__=''URL''
452
453
454 set the default index file to the specified
455 URL.
456
457
458 __-ismap__
459
460
461 toggles inclusion of ISMAP links when client-side MAPs are
462 present.
463
464
465 __-justify__
466
467
468 do justification of text.
469
470
471 __-link__=''NUMBER''
472
473
474 starting count for lnk#.dat files produced by
475 -crawl.
476
477
478 __-localhost__
479
480
481 disable URLs that point to remote hosts.
482
483
484 __-locexec__
485
486
487 enable local program execution from local files only (if
488 Lynx was compiled with local execution
489 enabled).
490
491
492 __-lss__=''FILENAME''
493
494
495 specify filename containing color-style information. The
496 default is lynx.lss.
497
498
499 __-mime_header__
500
501
502 prints the MIME header of a fetched document along with its
503 source.
504
505
506 __-minimal__
507
508
509 toggles minimal versus valid comment parsing.
510
511
512 __-newschunksize__=''NUMBER''
513
514
515 number of articles in chunked news listings.
516
517
518 __-newsmaxchunk__=''NUMBER''
519
520
521 maximum news articles in listings before
522 chunking.
523
524
525 __-nobold__
526
527
528 disable bold video-attribute.
529
530
531 __-nobrowse__
532
533
534 disable directory browsing.
535
536
537 __-nocc__
538
539
540 disable Cc: prompts for self copies of mailings. Note that
541 this does not disable any CCs which are incorporated within
542 a mailto URL or form ACTION.
543
544
545 __-nocolor__
546
547
548 force color mode off, overriding terminal capabilities and
549 any -color flags, COLORTERM variable, and saved .lynxrc
550 settings.
551
552
553 __-noexec__
554
555
556 disable local program execution. (DEFAULT)
557
558
559 __-nofilereferer__
560
561
562 disable transmissions of Referer headers for file
563 URLs.
564
565
566 __-nolist__
567
568
569 disable the link list feature in dumps.
570
571
572 __-nolog__
573
574
575 disable mailing of error messages to document
576 owners.
577
578
579 __-nonrestarting_sigwinch__
580
581
582 This flag is not available on all systems, Lynx needs to be
583 compiled with HAVE_SIGACTION defined. If available, this
584 flag ''may'' cause Lynx to react more immediately to
585 window changes when run within an __xterm__.
586
587
588 __-nopause__
589
590
591 disable forced pauses for statusline messages.
592
593
594 __-noprint__
595
596
597 disable most print functions.
598
599
600 __-noredir__
601
602
603 prevents automatic redirection and prints a message with a
604 link to the new URL.
605
606
607 __-noreferer__
608
609
610 disable transmissions of Referer headers.
611
612
613 __-noreverse__
614
615
616 disable reverse video-attribute.
617
618
619 __-nosocks__
620
621
622 disable SOCKS proxy usage by a SOCKSified Lynx.
623
624
625 __-nostatus__
626
627
628 disable the retrieval status messages.
629
630
631 __-nounderline__
632
633
634 disable underline video-attribute.
635
636
637 __-number_fields__
638
639
640 force numbering of links as well as form input
641 fields
642
643
644 __-number_links__
645
646
647 force numbering of links.
648
649
650 __-partial__
651
652
653 toggles display partial pages while loading.
654
655
656 __-partial_thres__=''NUMBER''
657
658
659 number of lines to render before repainting display with
660 partial-display logic
661
662
663 __-pauth__=''ID'':''PASSWD''
664
665
666 set authorization ID and password for a protected proxy
667 server at startup. Be sure to protect any script files which
668 use this switch.
669
670
671 __-popup__
672
673
674 toggles handling of single-choice SELECT options via popup
675 windows or as lists of radio buttons.
676
677
678 __-post_data__
679
680
681 properly formatted data for a post form are read in from
682 stdin and passed to the form. Input is terminated by a line
683 that starts with '---'.
684
685
686 __-preparsed__
687
688
689 show HTML source preparsed and reformatted when used with
690 -source or in source view.
691
692
693 __-prettysrc__
694
695
696 show HTML source view with lexical elements and tags in
697 color.
698
699
700 __-print__
701
702
703 enable print functions. (default)
704
705
706 __-pseudo_inlines__
707
708
709 toggles pseudo-ALTs for inlines with no ALT
710 string.
711
712
713 __-raw__
714
715
716 toggles default setting of 8-bit character translations or
717 CJK mode for the startup character set.
718
719
720 __-realm__
721
722
723 restricts access to URLs in the starting realm.
724
725
726 __-reload__
727
728
729 flushes the cache on a proxy server (only the first document
730 affected).
731
732
733 __-restrictions__=''[[option][[,option][[,option]...''
734
735
736 allows a list of services to be disabled selectively. Dashes
737 and underscores in option names can be intermixed. The
738 following list is printed if no options are
739 specified.
740
741
742 ''all'' - restricts all options listed
743 below.
744
745
746 ''bookmark'' - disallow changing the location of the
747 bookmark file.
748
749
750 ''bookmark_exec'' - disallow execution links via the
751 bookmark file.
752
753
754 ''change_exec_perms'' - disallow changing the eXecute
755 permission on files (but still allow it for directories)
756 when local file management is enabled.
757
758
759 ''default'' - same as command line option -anonymous.
760 Disables default services for anonymous users. Set to all
761 restricted, except for: inside_telnet, outside_telnet,
762 inside_ftp, outside_ftp, inside_rlogin, outside_rlogin,
763 inside_news, outside_news, telnet_port, jump, mail, print,
764 exec, and goto. The settings for these, as well as
765 additional goto restrictions for specific URL schemes that
766 are also applied, are derived from definitions within
767 userdefs.h.
768
769
770 ''dired_support'' - disallow local file
771 management.
772
773
774 ''disk_save'' - disallow saving to disk in the download
775 and print menus.
776
777
778 ''dotfiles'' - disallow access to, or creation of, hidden
779 (dot) files.
780
781
782 ''download'' - disallow some downloaders in the download
783 menu (does not imply disk_save restriction).
784
785
786 ''editor'' - disallow external editing.
787
788
789 ''exec'' - disable execution scripts.
790
791
792 ''exec_frozen'' - disallow the user from changing the
793 local execution option.
794
795
796 ''externals'' - disallow some
797 ''
798
799
800 ''file_url'' - disallow using G)oto, served links or
801 bookmarks for file: URLs.
802
803
804 ''goto'' - disable the 'g' (goto) command.
805
806
807 ''inside_ftp'' - disallow ftps for people coming from
808 inside your domain (utmp required for
809 selectivity).
810
811
812 ''inside_news'' - disallow USENET news posting for people
813 coming from inside your domain (utmp required for
814 selectivity).
815
816
817 ''inside_rlogin'' - disallow rlogins for people coming
818 from inside your domain (utmp required for
819 selectivity).
820
821
822 ''inside_telnet'' - disallow telnets for people coming
823 from inside your domain (utmp required for
824 selectivity).
825
826
827 ''jump'' - disable the 'j' (jump) command.
828
829
830 ''multibook'' - disallow multiple bookmarks.
831
832
833 ''mail'' - disallow mail.
834
835
836 ''news_post'' - disallow USENET News
837 posting.
838
839
840 ''options_save'' - disallow saving options in
841 .lynxrc.
842
843
844 ''outside_ftp'' - disallow ftps for people coming from
845 outside your domain (utmp required for
846 selectivity).
847
848
849 ''outside_news'' - disallow USENET news reading and
850 posting for people coming from outside your domain (utmp
851 required for selectivity). This restriction applies to
852 ''
853
854
855 ''outside_rlogin'' - disallow rlogins for people coming
856 from outside your domain (utmp required for
857 selectivity).
858
859
860 ''outside_telnet'' - disallow telnets for people coming
861 from outside your domain (utmp required for
862 selectivity).
863
864
865 ''print'' - disallow most print options.
866
867
868 ''shell'' - disallow shell escapes and lynxexec or
869 lynxprog G)oto's.
870
871
872 ''suspend'' - disallow Unix Control-Z suspends with
873 escape to shell.
874
875
876 ''telnet_port'' - disallow specifying a port in telnet
877 G)oto's.
878
879
880 ''useragent'' - disallow modifications of the User-Agent
881 header.
882
883
884 __-resubmit_posts__
885
886
887 toggles forced resubmissions (no-cache) of forms with method
888 POST when the documents they returned are sought with the
889 PREV_DOC command or from the History List.
890
891
892 __-rlogin__
893
894
895 disable recognition of rlogin commands.
896
897
898 __-scrollbar__
899
900
901 toggles showing scrollbar.
902
903
904 __-scrollbar_arrow__
905
906
907 toggles showing arrows at ends of the
908 scrollbar.
909
910
911 __-selective__
912
913
914 require .www_browsable files to browse
915 directories.
916
917
918 __-short_url__
919
920
921 show very long URLs in the status line with
922
923
924 __-show_cursor__
925
926
927 If enabled the cursor will not be hidden in the right hand
928 corner but will instead be positioned at the start of the
929 currently selected link. Show cursor is the default for
930 systems without FANCY_CURSES capabilities. The default
931 configuration can be changed in userdefs.h or lynx.cfg. The
932 command line switch toggles the default.
933
934
935 __-show_rate__
936
937
938 If enabled the transfer rate is shown in bytes/second. If
939 disabled, no transfer rate is shown. Use lynx.cfg or the
940 options menu to select KB/second and/or ETA.
941
942
943 __-soft_dquotes__
944
945
946 toggles emulation of the old Netscape and Mosaic bug which
947 treated '
948
949
950 __-source__
951
952
953 works the same as dump but outputs HTML source instead of
954 formatted text.
955
956
957 __-stack_dump__
958
959
960 disable SIGINT cleanup handler
961
962
963 __-startfile_ok__
964
965
966 allow non-http startfile and homepage with
967 -validate.
968
969
970 __-stdin__
971
972
973 read the startfile from standard input (UNIX
974 only).
975
976
977 __-syslog__=''text''
978
979
980 information for syslog call.
981
982
983 __-tagsoup__
984
985
986 initialize parser, using Tag Soup DTD rather than
987 SortaSGML.
988
989
990 __-telnet__
991
992
993 disable recognition of telnet commands.
994
995
996 __-term__=''TERM''
997
998
999 tell Lynx what terminal type to assume it is talking to.
1000 (This may be useful for remote execution, when, for example,
1001 Lynx connects to a remote TCP/IP port that starts a script
1002 that, in turn, starts another Lynx process.)
1003
1004
1005 __-timeout__=''N''
1006
1007
1008 For win32, sets the network read-timeout, where N is given
1009 in seconds.
1010
1011
1012 __-tlog__
1013
1014
1015 toggles between using a Lynx Trace Log and stderr for trace
1016 output from the session.
1017
1018
1019 __-tna__
1020
1021
1022 turns on
1023
1024
1025 __-trace__
1026
1027
1028 turns on Lynx trace mode. Destination of trace output
1029 depends on -tlog.
1030
1031
1032 __-trace_mask__=''value''
1033
1034
1035 turn on optional traces, which may result in very large
1036 trace files. Logically OR the values to combine options:
1037 1=SGML character parsing states
1038 2=color-style
1039 4=TRST (table layout)
1040
1041
1042 __-traversal__
1043
1044
1045 traverse all http links derived from startfile. When used
1046 with -crawl, each link that begins with the same string as
1047 startfile is output to a file, intended for indexing. See
1048 CRAWL.announce for more information.
1049
1050
1051 __trim_input_fields__
1052
1053
1054 trim input text/textarea fields in forms.
1055
1056
1057 __-underscore__
1058
1059
1060 toggles use of _underline_ format in dumps.
1061
1062
1063 __-use_mouse__
1064
1065
1066 turn on mouse support, if available. Clicking the left mouse
1067 button on a link traverses it. Clicking the right mouse
1068 button pops back. Click on the top line to scroll up. Click
1069 on the bottom line to scroll down. The first few positions
1070 in the top and bottom line may invoke additional functions.
1071 Lynx must be compiled with __ncurses__ or __slang__ to
1072 support this feature. If __ncurses__ is used, clicking
1073 the middle mouse button pops up a simple menu. Mouse clicks
1074 may only work reliably while Lynx is idle waiting for
1075 input.
1076
1077
1078 __-useragent=Name__
1079
1080
1081 set alternate Lynx User-Agent header.
1082
1083
1084 __-validate__
1085
1086
1087 accept only http URLs (for validation). Complete security
1088 restrictions also are implemented.
1089
1090
1091 __-verbose__
1092
1093
1094 toggle [[LINK], [[IMAGE] and [[INLINE] comments with filenames
1095 of these images.
1096
1097
1098 __-version__
1099
1100
1101 print version information.
1102
1103
1104 __-vikeys__
1105
1106
1107 enable vi-like key movement.
1108
1109
1110 __-wdebug__
1111
1112
1113 enable Waterloo tcp/ip packet debug (print to watt
1114 debugfile). This applies only to DOS versions compiled with
1115 WATTCP or WATT-32.
1116
1117
1118 __-width__=''NUMBER''
1119
1120
1121 number of columns for formatting of dumps, default is
1122 80.
1123
1124
1125 __-with_backspaces__
1126
1127
1128 emit backspaces in output if -dumping or -crawling (like
1129 'man' does)
1130 !!COMMANDS
1131
1132
1133 o Use __Up arrow__ and __Down arrow__ to scroll
1134 through hypertext links.
1135 o __Right arrow__ or __Return__ will follow a
1136 highlighted hypertext link.
1137 o __Left Arrow__ will retreat from a link.
1138 o Type ____ or ____ for
1139 online help and descriptions of key-stroke commands.
1140 o Type ____ for a complete list of the
1141 current key-stroke command mappings.
1142 !!ENVIRONMENT
1143
1144
1145 In addition to various
1146 HOME__, __PATH__, __USER__,
1147 __DISPLAY__, __TMPDIR__, __etc__, ''Lynx''
1148 utilizes several Lynx-specific environment variables, if
1149 they exist.
1150
1151
1152 Others may be created or modified by ''Lynx'' to pass
1153 data to an external program, or for other reasons. These are
1154 listed separately below.
1155
1156
1157 See also the sections on __SIMULATED CGI SUPPORT__ and
1158 __NATIVE LANGUAGE SUPPORT__, below.
1159
1160
1161 Note: Not all environment variables apply to all types of
1162 platforms supported by ''Lynx'', though most do. Feedback
1163 on platform dependencies is solicited.
1164
1165
1166 Environment Variables Used By ''Lynx'':
1167
1168
1169 __COLORTERM__ If set, color capability for the terminal
1170 is forced on at startup time. The actual value assigned to
1171 the variable is ignored. This variable is only meaningful if
1172 ''Lynx'' was built using the __slang__ screen-handling
1173 library.
1174
1175
1176 __LYNX_CFG__ This variable, if set, will override the
1177 default location and name of the global configuration file
1178 (normally, __lynx.cfg__) that was defined by the
1179 LYNX_CFG_FILE constant in the userdefs.h file, during
1180 installation. See the userdefs.h file for more
1181 information.
1182
1183
1184 __LYNX_LSS__ This variable, if set, specifies the
1185 location of the default ''Lynx'' character style sheet
1186 file. [[Currently only meaningful if ''Lynx'' was built
1187 using experimental color style support.]
1188
1189
1190 __LYNX_SAVE_SPACE__
1191
1192
1193 This variable, if set, will override the default path prefix
1194 for files saved to disk that is defined in the __lynx.cfg
1195 SAVE_SPACE:__ statement. See the __lynx.cfg__ file for
1196 more information.
1197
1198
1199 __LYNX_TEMP_SPACE__
1200
1201
1202 This variable, if set, will override the default path prefix
1203 for temporary files that was defined during installation, as
1204 well as any value that may be assigned to the __TMPDIR__
1205 variable.
1206
1207
1208 __MAIL__ This variable specifies the default inbox
1209 ''Lynx'' will check for new mail, if such checking is
1210 enabled in the __lynx.cfg__ file.
1211
1212
1213 __NEWS_ORGANIZATION__
1214
1215
1216 This variable, if set, provides the string used in the
1217 __Organization:__ header of __USENET__ news postings.
1218 It will override the setting of the ORGANIZATION environment
1219 variable, if it is also set (and, on __UNIX__, the
1220 contents of an /etc/organization file, if
1221 present).
1222
1223
1224 __NNTPSERVER__ If set, this variable specifies the
1225 default NNTP server that will be used for __USENET__ news
1226 reading and posting with ''Lynx'', via news:
1227 URL's.
1228
1229
1230 __ORGANIZATION__ This variable, if set, provides the
1231 string used in the __Organization:__ header of
1232 __USENET__ news postings. On __UNIX__, it will
1233 override the contents of an /etc/organization file, if
1234 present.
1235
1236
1237 __PROTOCOL_proxy__
1238
1239
1240 ''Lynx'' supports the use of proxy servers that can act
1241 as firewall gateways and caching servers. They are
1242 preferable to the older gateway servers (see
1243 WWW_access_GATEWAY, below). Each protocol used by
1244 ''Lynx'', (http, ftp, gopher, etc), can be mapped
1245 separately by setting environment variables of the form
1246 PROTOCOL_proxy (literally: http_proxy, ftp_proxy,
1247 gopher_proxy, etc), to
1248 ''Lynx Users
1249 Guide__ for additional details and examples.
1250
1251
1252 __WWW_access_GATEWAY__
1253
1254
1255 ''Lynx'' still supports use of gateway servers, with the
1256 servers specified via
1257 ''Lynx Users Guide__ for
1258 details.
1259
1260
1261 __WWW_HOME__ This variable, if set, will override the
1262 default startup URL specified in any of the ''Lynx''
1263 configuration files.
1264
1265
1266 Environment Variables __Set__ or __Modified__ By
1267 ''Lynx'':
1268
1269
1270 __LYNX_PRINT_DATE__
1271
1272
1273 This variable is set by the ''Lynx'' p(rint) function, to
1274 the __Date:__ string seen in the document's
1275 __Information about__
1276 __lynx.cfg PRINTER:__ definition statement. If the
1277 field does not exist for the document, the variable is set
1278 to a null string under __UNIX__, or
1279 __VMS__.
1280
1281
1282 __LYNX_PRINT_LASTMOD__
1283
1284
1285 This variable is set by the ''Lynx'' p(rint) function, to
1286 the __Last Mod:__ string seen in the document's
1287 __Information about__
1288 __lynx.cfg PRINTER:__ definition statement. If the
1289 field does not exist for the document, the variable is set
1290 to a null string under __UNIX__, or
1291 __VMS__.
1292
1293
1294 __LYNX_PRINT_TITLE__
1295
1296
1297 This variable is set by the ''Lynx'' p(rint) function, to
1298 the __Linkname:__ string seen in the document's
1299 __Information about__
1300 __lynx.cfg PRINTER:__ definition statement. If the
1301 field does not exist for the document, the variable is set
1302 to a null string under __UNIX__, or
1303 __VMS__.
1304
1305
1306 __LYNX_PRINT_URL__
1307
1308
1309 This variable is set by the ''Lynx'' p(rint) function, to
1310 the __URL:__ string seen in the document's
1311 __Information about__
1312 __lynx.cfg PRINTER:__ definition statement. If the
1313 field does not exist for the document, the variable is set
1314 to a null string under __UNIX__, or
1315 __VMS__.
1316
1317
1318 __LYNX_TRACE__ If set, causes ''Lynx'' to write a
1319 trace file as if the __-trace__ option were
1320 supplied.
1321
1322
1323 __LYNX_VERSION__ This variable is always set by
1324 ''Lynx'', and may be used by an external program to
1325 determine if it was invoked by ''Lynx''. See also the
1326 comments in the distribution's sample __mailcap__ file,
1327 for notes on usage in such a file.
1328
1329
1330 __TERM__ Normally, this variable is used by ''Lynx''
1331 to determine the terminal type being used to invoke
1332 ''Lynx''. If, however, it is unset at startup time (or
1333 has the value ''-term__
1334 command-line option is used (see __OPTIONS__ section
1335 above), ''Lynx'' will set or modify its value to the user
1336 specified terminal type (for the ''Lynx'' execution
1337 environment). Note: If set/modified by ''Lynx'', the
1338 values of the __LINES__ and/or __COLUMNS__ environment
1339 variables may also be changed.
1340 !!SIMULATED CGI SUPPORT
1341
1342
1343 If built with the __cgi-links__ option enabled,
1344 ''Lynx'' allows access to a cgi script directly without
1345 the need for an http daemon.
1346
1347
1348 When executing such
1349
1350
1351 __CONTENT_LENGTH__
1352
1353
1354 __CONTENT_TYPE__
1355
1356
1357 __DOCUMENT_ROOT__
1358
1359
1360 __HTTP_ACCEPT_CHARSET__
1361
1362
1363 __HTTP_ACCEPT_LANGUAGE__
1364
1365
1366 __HTTP_USER_AGENT__
1367
1368
1369 __PATH_INFO__
1370
1371
1372 __PATH_TRANSLATED__
1373
1374
1375 __QUERY_STRING__
1376
1377
1378 __REMOTE_ADDR__
1379
1380
1381 __REMOTE_HOST__
1382
1383
1384 __REQUEST_METHOD__
1385
1386
1387 __SERVER_SOFTWARE__
1388
1389
1390 Other environment variables are not inherited by the script,
1391 unless they are provided via a LYNXCGI_ENVIRONMENT statement
1392 in the configuration file. See the __lynx.cfg__ file, and
1393 the (draft) CGI 1.1 Specification
1394 __
1395
1396
1397 The CGI Specification, and other associated documentation,
1398 should be consulted for general information on CGI script
1399 programming.
1400 !!NATIVE LANGUAGE SUPPORT
1401
1402
1403 If configured and installed with __Native Language
1404 Support__, ''Lynx'' will display status and other
1405 messages in your local language. See the file
1406 __ABOUT_NLS__ in the source distribution, or at your
1407 local __GNU__ site, for more information about
1408 internationalization.
1409
1410
1411 The following environment variables may be used to alter
1412 default settings:
1413
1414
1415 __LANG__ This variable, if set, will override the default
1416 message language. It is an __ISO 639__ two-letter code
1417 identifying the language. Language codes are __NOT__ the
1418 same as the country codes given in __ISO
1419 3166__.
1420
1421
1422 __LANGUAGE__ This variable, if set, will override the
1423 default message language. This is a __GNU__ extension
1424 that has higher priority for setting the message catalog
1425 than __LANG__ or __LC_ALL__.
1426
1427
1428 __LC_ALL__ and
1429
1430
1431 __LC_MESSAGES__ These variables, if set, specify the
1432 notion of native language formatting style. They are
1433 __POSIXly__ correct.
1434
1435
1436 __LINGUAS__ This variable, if set prior to configuration,
1437 limits the installed languages to specific values. It is a
1438 space-separated list of two-letter codes. Currently, it is
1439 hard-coded to a wish list.
1440
1441
1442 __NLSPATH__ This variable, if set, is used as the path
1443 prefix for message catalogs.
1444 !!NOTES
1445
1446
1447 This is the Lynx v2.8.4 Release
1448
1449
1450 If you wish to contribute to the further development of
1451 ''Lynx'', subscribe to our mailing list. Send email to
1452 ''
1453
1454
1455 Send bug reports, comments, suggestions to
1456
1457
1458 Unsubscribe by sending email to
1459 !!SEE ALSO
1460
1461
1462 catgets(3), curses(3), environ(7),
1463 execve(2), ftp(1), ''gettext''(GNU),
1464 localeconv(3), ncurses(3),
1465 setlocale(3), ''slang''(?), termcap(5),
1466 terminfo(5), ''wget''(GNU)
1467
1468
1469 Note that man page availability and section numbering is
1470 somewhat platform dependent, and may vary from the above
1471 references.
1472
1473
1474 A section shown as (GNU), is intended to denote that the
1475 topic may be available via an info page, instead of a man
1476 page (i.e., try
1477
1478
1479 A section shown as (?) denotes that documentation on the
1480 topic exists, but is not part of an established documenta-
1481 tion retrieval system (see the distribution files associ-
1482 ated with the topic, or contact your System Administrator
1483 for further information).
1484 !!ACKNOWLEDGMENTS
1485
1486
1487 Lynx has incorporated code from a variety of sources along
1488 the way. The earliest versions of Lynx included code from
1489 Earl Fogel of Computing Services at the University of
1490 Saskatchewan, who implemented HYPERREZ in the Unix envi-
1491 ronment. HYPERREZ was developed by Niel Larson of Think.com
1492 and served as the model for the early versions of Lynx.
1493 Those versions also incorporated libraries from the Unix
1494 Gopher clients developed at the University of Minnesota, and
1495 the later versions of Lynx rely on the WWW client library
1496 code developed by Tim Berners-Lee and the WWW community.
1497 Also a special thanks to Foteos Macrides who ported much of
1498 Lynx to VMS and did or organized most of its development
1499 since the departures of Lou Montulli and Garrett Blythe from
1500 the University of Kansas in the summer of 1994 through the
1501 release of v2.7.2, and to ev- eryone on the net who has
1502 contributed to Lynx's develop- ment either directly (through
1503 patches, comments or bug re- ports) or indirectly (through
1504 inspiration and development of other systems).
1505 !!AUTHORS
1506
1507
1508 Lou Montulli, Garrett Blythe, Craig Lavender, Michael Grobe,
1509 Charles Rezac
1510 Academic Computing Services
1511 University of Kansas
1512 Lawrence, Kansas 66047
1513
1514
1515 Foteos Macrides
1516 Worcester Foundation for Biomedical Research
1517 Shrewsbury, Massachusetts 01545
1518 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.