LYNX(1)                                                   LYNX(1)

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

SYNOPSIS
       Lynx [options] [path or URL]

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

DESCRIPTION
       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
       containing 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, VMS, Windows95/NT, 386DOS and OS/2 EMX.

       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
       addition, Lynx can  be  used  to  build  systems  isolated
       within a single LAN.

OPTIONS
       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 argument is only '-', 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).

       -accept_all_cookies
              accept all cookies.

       -anonymous
              used to specify the anonymous account.

       -assume_charset=ID:MIMEname
              charset for documents that don't specify it.

       -assume_local_charset=ID:MIMEname
              charset assumed for local files.

       -assume_unrec_charset=MIMEname
              use this instead of unrecognized charsets.

       -auth=ID:PASSWD
              set authorization ID  and  password  for  protected
              documents  at  startup.   Be  sure  to  protect any
              script files which use this switch.

       -base  prepend a request  URL  comment  and  BASE  tag  to
              text/html outputs for -source dumps.

       -blink forces  high intensity bg colors for color mode, if
              available and  supported  by  the  terminal.   Lynx
              needs  to  be  compiled  with the slang library for
              this flag.

       -book  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 unavailable or blank.

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

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

       -case  enable case-sensitive string searching.

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

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

       -color forces color mode on, if available.  Default  color
              control  sequences  which  work  for  many terminal
              types  are  assumed  if  the  terminal   capability
              description  does  not specify how to handle color.
              Lynx needs to be compiled with  the  slang  library
              for  this  flag.  A saved show_color=always setting
              found in a .lynxrc file at  startup  has  the  same
              effect.  A saved show_color=always found in .lynxrc
              on startup is overridden by this flag.

       -cookies
              toggles handling of Set-Cookie headers.

       -cookie_file=FILENAME
              specifies a file to use to store cookies.

       -core  toggles forced core dumps on fatal errors.

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

       -debug_partial
              incremental display stages with MessageSecs delay

       -display=DISPLAY
              set the display variable for X rexec-ed programs.

       -dump  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 http://www.crl.com/~subir/lynx.html.

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

       -emacskeys
              enable emacs-like key movement.

       -enable_scrollback
              toggles  compatibility  with comm programs' scroll-
              back keys (may be  incompatible  with  some  curses
              packages).

       -error_file=FILE
              define  a  file  where Lynx will report HTTP access
              codes.

       -exec  enable local program execution (normally  not  con-
              figured).

       -fileversions
              include  all  versions of files in local VMS direc-
              tory listings.

       -force_html
              forces the first  document  to  be  interpreted  as
              HTML.

       -force_secure
              toggles forcing of the secure flag for SSL cookies.

       -forms_options
              toggles the style of options (menu or forms).

       -from  toggles transmissions of From headers.

       -ftp   disable ftp access.

       -get_data
              send form data from stdin using GET method and dump
              results.

       -head  send a HEAD request for the mime headers.

       -help  print the Lynx command syntax usage message.

       -hiddenlinks=[option]
              control the display of hidden links.

              merge hidden links show up as bracketed numbers and
              are numbered  together  with  other  links  in  the
              sequence of their occurrence in the document.

              listonly  hidden  links  are  shown  only  on L)ist
              screens and listings generated by -dump or from the
              P)rint  menu,  but  appear separately at the end of
              those lists.  This is the default behavior.

              ignore hidden links do not appear even in listings.

       -historical
              toggles  use  of  '>'  or '-->' as a terminator for
              comments.

       -homepage=URL
              set homepage separate from start page.

       -image_links
              toggles inclusion of links for all images.

       -index=URL
              set the default index file to the specified URL.

       -ismap toggles inclusion of ISMAP links  when  client-side
              MAPs are present.

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

       -localhost
              disable URLs that point to remote hosts.

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

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

       -minimal
              toggles minimal versus valid comment parsing.

       -newschunksize=NUMBER
              number of articles in chunked news listings.

       -newsmaxchunk=NUMBER
              maximum  news articles in listings before chunking.

       -nobrowse
              disable directory browsing.

       -nocc  disable Cc: prompts for self  copies  of  mailings.
              Note  that  this does not disable any CCs which are
              incorporated within a mailto URL or form ACTION.

       -nocolor
              force color mode off, overriding terminal capabili-
              ties  and any -color flags, COLORTERM variable, and
              saved .lynxrc settings.

       -noexec
              disable local program execution. (DEFAULT)

       -nofilereferer
              disable transmissions of Referer headers  for  file
              URLs.

       -nolist
              disable the link list feature in dumps.

       -nolog disable  mailing of error messages to document own-
              ers.

       -nopause
              disable forced pauses for statusline messages.

       -noprint
              disable print functions.

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

       -noreferer
              disable transmissions of Referer headers.

       -nosocks
              disable SOCKS proxy usage by a SOCKSified Lynx.

       -nostatus
              disable the retrieval status messages.

       -number_links
              force numbering of links.

       -partial
              display partial pages while downloading.

       -pauth=ID:PASSWD
              set  authorization  ID and password for a protected
              proxy server at startup.  Be sure  to  protect  any
              script files which use this switch.

       -popup toggles  handling  of  single-choice SELECT options
              via popup windows or as lists of radio buttons.

       -post_data
              send form data from stdin  using  POST  method  and
              dump results.

       -preparsed
              show  HTML  source  preparsed  and reformatted when
              used with -source or in source view.

       -print enable print functions. (default)

       -pseudo_inlines
              toggles pseudo-ALTs for inlines with no ALT string.

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

       -realm restricts access to URLs in the starting realm.

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

       -restrictions=[option][,option][,option]...
              allows  a  list  of  services to be disabled selec-
              tively.   The  following  list  is  printed  if  no
              options are specified.

              all - restricts all options.

              bookmark  -  disallow  changing the location of the
              bookmark file.

              bookmark_exec - disallow execution  links  via  the
              bookmark file.

              change_exec_perms  -  disallow changing the eXecute
              permission on files (but still allow it for  direc-
              tories) when local file management is enabled.

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

              dired_support - disallow local file management.

              disk_save - disallow saving to disk in the download
              and print menus.

              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
              bookmarks 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 peo-
              ple coming from inside your domain  (utmp  required
              for selectivity).

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

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

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

              multibook - disallow multiple bookmarks.

              mail - disallow mail.

              news_post - disallow USENET News posting.

              options_save  - disallow saving options in .lynxrc.

              outside_ftp - disallow ftps for people coming  from
              outside  your  domain  (utmp required for selectiv-
              ity).

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

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

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

              print - disallow most print options.

              shell - disallow  shell  escapes  and  lynxexec  or
              lynxprog G)oto's.

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

              telnet_port - disallow specifying a port in  telnet
              G)oto's.

              useragent  -  disallow  modifications  of the User-
              Agent header.

       -resubmit_posts
              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.

       -rlogin
              disable recognition of rlogin commands.

       -selective
              require .www_browsable files to browse directories.

       -show_cursor
              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.  The default  configura-
              tion can be changed in userdefs.h or lynx.cfg.  The
              command line switch toggles the default.

       -soft_dquotes
              toggles emulation of the old  Netscape  and  Mosaic
              bug  which  treated '>' as a co-terminator for dou-
              ble-quotes and tags.

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

       -stack_dump
              disable SIGINT cleanup handler

       -startfile_ok
              allow  non-http  startfile and homepage with -vali-
              date.

       -tagsoup
              initialize parser, using Tag Soup DTD  rather  than
              SortaSGML.

       -telnet
              disable recognition of telnet commands.

       -term=TERM
              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 process.)

       -tlog  toggles  use  of  a  Lynx Trace Log for the current
              session.

       -trace turns on WWW trace mode.

       -traversal
              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.

       -underscore
              toggles use of _underline_ format in dumps.

       -use_mouse
              turn on xterm mouse  support.   Clicking  the  left
              mouse  button on a link traverses it.  Clicking the
              right mouse button pops back.  Click in  the  first
              line  of  a  page  to scroll up.  Click in the last
              line of a page to scroll down.  Lynx must  be  com-
              piled  with  ncurses  or slang to support this fea-
              ture.

       -useragent=Name
              set alternate Lynx User-Agent header.

       -validate
              accept only http URLs (for  validation).   Complete
              security restrictions also are implemented.

       -verbose
              taggles  [LINK], [IMAGE] and [INLINE] comments with
              filenames of these images.

       -version
              print version information.

       -vikeys
              enable vi-like key movement.

       -width=NUMBER
              number of columns for formatting of dumps,  default
              is 80.

COMMANDS
       o  Use Up arrow and Down arrow to scroll through hypertext
       links.
       o Right arrow or Return will follow a  highlighted  hyper-
       text link.
       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.

NOTES
       This is the Lynx v2.8.1 Release

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

       Send  bug  reports,  comments,   suggestions   to   <lynx-
       dev@sig.net> after subscribing.

       Unsubscribe  by  sending email to <majordomo@sig.net> 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.

ACKNOWLEDGMENTS
       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 envi-
       ronment.   HYPERREZ  was  developed  by  Niel  Larson   of
       Think.com  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  release  of  v2.7.2,  and  to
       everyone on the net who has contributed to Lynx's develop-
       ment either directly (through  patches,  comments  or  bug
       reports)  or  indirectly (through inspiration and develop-
       ment of other systems).

AUTHORS
       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

                              Local                             1