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