lynx - a general purpose distributed information browser for
     the World Wide Web

     Lynx [options] [path or URL]

     use "lynx -help" to  display  a  complete  list  of  current

     Lynx is a fully-featured World Wide  Web  (WWW)  client  for
     users  running  cursor-addressable,  character-cell  display
     devices (e.g., vt100 terminals, vt100 emulators  running  on
     PCs  or  Macs,  or any other "curses-oriented" display).  It
     will display hypertext markup language (HTML) documents con-
     taining links to files residing on the local system, as well
     as files residing on remote systems  running  Gopher,  HTTP,
     FTP,  WAIS,  and NNTP servers.  Current versions of Lynx run
     on Unix and VMS.

     Lynx can be used to access information  on  the  World  Wide
     Web,  or to build information systems intended primarily for
     local access.  For example, Lynx  has  been  used  to  build
     several  Campus  Wide  Information Systems (CWIS).  In addi-
     tion, Lynx can be used to build systems  isolated  within  a
     single LAN.

     At start up, Lynx will load any local  file  or  remote  URL
     specified  at  the  command line.  For help with URLs, press
     "?" or "h" while running Lynx.  Then follow the link titled,
     "Help on URLs."

     -    If the only argument  is  '-',  then  Lynx  expects  to
          receive  the arguments from stdin. This is to allow for
          the potentially very long  command  line  that  can  be
          associated  with  the -get_data or -post_data arguments
          (see below).

          used to specify the anonymous account.

          set authorization ID and password for  protected  docu-
          ments at startup.

          use the bookmark page as the startfile.  The default or
          command line startfile is still set for the Main screen
          command, and will be used if the bookmark page is  una-
          vailable or blank.

          toggles scanning of news  articles  for  buried  refer-
          ences,  and  converts  them  to news links.  Not recom-
          mended because email addresses enclosed in angle brack-
          ets  will  be  converted to false news links, and uuen-
          coded messages can be trashed.

          set the NUMBER of  documents  cached  in  memory.   The
          default is 10.

          enable case-sensitive string searching.

          specifies a Lynx  configuration  file  other  than  the
          default lynx.cfg.

          exit on left-arrow in startfile, and  disable  save  to

          with -traversal, output each  page  to  a  file.   with
          -dump, format output as with -traversal, but to stdout.

          set the display variable for X rexec-ed programs.

          dumps the formatted output of the default  document  or
          one specified on the command line to standard out. This
          can  be  used  in  the  following   way:   lynx   -dump

          enable edit mode using the specified EDITOR.  (vi,  ed,
          emacs, etc.)

          enable emacs-like key movement.

          toggle compatibility  with  comm  programs'  scrollback
          keys (may be incompatible with some curses packages).

          define a file where Lynx will report HTTP access codes.

          include all versions of files in  local  VMS  directory

          forces the first document to be interpreted as HTML.

     -ftp disable ftp access.

          send form data from stdin using  GET  method  and  dump

          send a HEAD request for the mime headers.

          print this Lynx command syntax usage message.

          toggles use of '>' or '-->' as a  terminator  for  com-

          set homepage separate from start page.

          toggles inclusion of links for all images.

          set the default index file to the specified URL.

          starting count for lnk#.dat files produced by -crawl.

          disable URLs that point to remote hosts.

          enable local program execution from  local  files  only
          (if Lynx was compiled with local execution enabled).

          prints the MIME header of a fetched document along with
          its source.

          toggles minimal versus valid comment parsing.

          number of articles in chunked news listings.

          maximum news articles in listings before chunking.

          disable directory browsing.

          disable local program execution. (DEFAULT)

          disable transmissions of Referer headers for file URLs.

          disable transmissions of From headers.

          disable the link list feature in dumps.

          disable mailing of error messages to document owners.

          disable print functions.

          prevents automatic redirection  and  prints  a  message
          with a link to the new URL.

          disable transmissions of Referer headers.

          disable SOCKS proxy usage by a SOCKSified Lynx.

          disable the retrieval status messages.

          force numbering of links.

          send form data from stdin using POST  method  and  dump

          enable print functions. (default)

          toggles pseudo-ALTs for inlines with no ALT string.

     -raw toggles default setting of 8-bit character translations
          or CJK mode for the startup character set.

          restricts access to URLs in the starting realm.

          flushes the cache on a proxy  server  (only  the  first
          document affected).

          allows a list of services to be  disabled  selectively.
          The  following list is printed if no options are speci-

          all - restricts all options.

          bookmark - disallow changing the location of the  book-
          mark file.

          bookmark_exec - disallow execution links via the  book-
          mark file.

          change_exec_perms - disallow changing the eXecute  per-
          mission  on  files (but still allow it for directories)
          when local file management is enabled.

          default - same as command line option -anonymous.  Dis-
          ables  default  services for anonymous users. Currently
          set  to  all  restricted  except  for:   inside_telnet,
          outside_telnet,  inside_news,  inside_ftp, outside_ftp,
          inside_rlogin, outside_rlogin,  jump,  mail  and  goto.
          Defaults are setable within userdefs.h.

          dired_support - disallow local file management.

          disk_save - disallow saving binary files to disk in the
          download menu.

          download - disallow downloaders in the download menu.

          editor - disallow editing.

          exec - disable execution scripts.

          exec_frozen - disallow the user from changing the local
          execution option.

          file_url - disallow using G)oto, served links or  book-
          marks for file: URLs.

          goto - disable the 'g' (goto) command.

          inside_ftp -  disallow  ftps  for  people  coming  from
          inside your domain (utmp required for selectivity).

          inside_news - disallow USENET news posting  for  people
          coming  from  inside  your  domain  (utmp  required for

          inside_rlogin - disallow rlogins for people coming from
          inside your domain (utmp required for selectivity).

          inside_telnet - disallow telnets for people coming from
          inside your domain (utmp required for selectivity).

          jump - disable the 'j' (jump) command.

          mail - disable mailing feature.

          news_post - disable USENET News posting.

          options_save - disallow saving options in .lynxrc.

          outside_ftp - disallow ftps for people coming from out-
          side your domain (utmp required for selectivity).

          outside_news - disallow USENET news posting for  people
          coming  from  outside  your  domain  (utmp required for

          outside_rlogin - disallow  rlogins  for  people  coming
          from  outside  your  domain  (utmp  required for selec-

          outside_telnet - disallow  telnets  for  people  coming
          from  outside  your  domain  (utmp  required for selec-

          print - disallow most print options.

          shell - disallow shell escapes and lynxexec or lynxprog

          suspend - disallow Unix Control-Z suspends with  escape
          to shell.

          telnet_port - disallow  specifying  a  port  in  telnet

          useragent - disallow modifications  of  the  User-Agent

          toggles forced resubmissions (no-cache) of  forms  with
          method POST when the documents they returned are sought
          with the PREV_DOC command or from the History List.

          disable recognition of rlogin commands.

          require .www_browsable files to browse directories.

          If enabled the cursor will not be hidden in  the  right
          hand corner but will instead be positioned at the start
          of the currently selected  link.  show  cursor  is  the
          default  for systems without FANCY_CURSES capabilities,
          and  the  default  configuration  can  be  changed   in

          works the same as dump but outputs HTML source  instead
          of formatted text.

          allow non-http startfile and homepage with -validate.

          disable recognition of telnet commands.

          tell Lynx what terminal type to assume its talking  to.
          (This  may  be  useful  for remote execution, when, for
          example, Lynx connects to a  remote  TCP/IP  port  that
          starts a script that, in turn, starts another Lynx pro-

          turns on WWW trace mode.

          traverse all http links derived from  startfile.   When
          used  with  -crawl, each link that begins with the same
          string as startfile is output to a file,  intended  for
          indexing.  See CRAWL.announce for more information.

          toggles use of _underline_ format in dumps.

          accept only http URLs (for validation).  Complete secu-
          rity restrictions also are implemented.

          print version information.

          enable vi-like key movement.

     o Use Up arrow and Down arrow to  scroll  through  hypertext
     o Right arrow or Return will follow a highlighted  hypertext
     o Left Arrow will retreat from a link.
     o Type "h" or "?" for online help and descriptions  of  key-
     stroke commands.
     o Type "k" for a complete list  of  the  current  key-stroke
     command mappings.

     This is the Lynx v2.6 Release for Unix/VMS

     If you wish to contribute  to  the  further  development  of
     Lynx,   subscribe  to  our  mailing  list.   Send  email  to
     <> with "subscribe lynx-dev"  as  the  only
     line in the body of your message.

     Send  bug   reports,   comments,   suggestions   to   <lynx-> after subscribing.

     Unsubscribe by sending  email  to  <>  with
     "unsubscribe  lynx-dev" as the only line in the body of your
     message.  Do not send the unsubscribe message to  the  lynx-
     dev list, itself.

     Lynx has incorporated code from a variety of  sources  along
     the  way.   The earliest versions of Lynx included code from
     Earl Fogel  of  Computing  Services  at  the  University  of
     Saskatchewan,  who implemented HYPERREZ in the Unix environ-
     ment.  HYPERREZ was developed by Niel  Larson  of
     and  served  as  the  model  for the early versions of Lynx.
     Those versions also incorporated  libraries  from  the  Unix
     Gopher clients developed at the University of Minnesota, and
     the later versions of Lynx rely on the  WWW  client  library
     code  developed  by  Tim  Berners-Lee and the WWW community.
     Also a special thanks to Foteos Macrides who ported much  of
     Lynx  to  VMS  and  did or organized most of its development
     since the departures of Lou Montulli and Garrett Blythe from
     the  University  of Kansas in the summer of 1994 through the
     current release of v2.6, and to everyone on the net who  has
     contributed  to  Lynx's development either directly (through
     patches, comments or bug  reports)  or  indirectly  (through
     inspiration and development of other systems).

     Lou Montulli, Garrett Blythe, Craig Lavender, Michael Grobe,
     Charles Rezac
     Academic Computing Services
     University of Kansas
     Lawrence, Kansas 66047

     Foteos Macrides
     Worcester Foundation for Biomedical Research
     Shrewsbury, Massachusetts 01545