


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

       -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=ID:MIMEname
              use this instead of unrecognized charsets.





                              Local                             1





LYNX(1)                                                   LYNX(1)


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

       -core  toggles forced core dumps on fatal errors.

       -crawl with -traversal, output each page to a file.   with



2                             Local





LYNX(1)                                                   LYNX(1)


              -dump,  format  output  as  with -traversal, but to
              stdout.

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

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

       -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 this Lynx command syntax usage message.

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

              merge hidden links show up as bracketed numbers and



                              Local                             3





LYNX(1)                                                   LYNX(1)


              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.




4                             Local





LYNX(1)                                                   LYNX(1)


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

       -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



                              Local                             5





LYNX(1)                                                   LYNX(1)


              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.



6                             Local





LYNX(1)                                                   LYNX(1)


              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



                              Local                             7





LYNX(1)                                                   LYNX(1)


              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.

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

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

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




8                             Local





LYNX(1)                                                   LYNX(1)


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

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

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

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



                              Local                             9





LYNX(1)                                                   LYNX(1)


       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
























10                            Local


