LINKS(1)                                                 LINKS(1)



NAME
       links - lynx-like alternative character mode WWW browser

SYNOPSIS
       links [options] URL

DESCRIPTION
       links  is  a text mode WWW browser with ncurses interface,
       supporting colors,  correct  table  rendering,  background
       downloading,  menu driven configuration interface and slim
       code.

       Frames are supported. You can have different file  formats
       associated  with external viewers. mailto: and telnet: are
       supported via external clients.

       links can handle local (file://)  or  remote  (http://  or
       ftp://) URLs.



OPTIONS
       Most  options  can  be set in the user interface or config
       file, so usually you do not need to care about them.


       -g     Run Links in graphics mode.  If  not  given,  Links
              will  run  in  text mode.  Running in graphics mode
              means that Links will probe all compiled-in  graph-
              ics  devices  and  run  on the first found. If none
              found, links will not run in text mode. This option
              works only if --enable-graphics was given to ./con-
              figure.


       -mode 
              Pass  a  parameter  to  the  graphics  driver.   On
              SVGAlib,  this  is widthxheightxdepth, (where depth
              is 16, 256, 32K, 64K, 16M or 16M32) and defines the
              graphics  mode, on X the format is widthxheight and
              defines the window size.


       -async-dns <0>/<1>
              Asynchronous DNS resolver on(1)/off(0).


       -max-connections 
              Maximum   number   of    concurrent    connections.
              (default: 10)


       -max-connections-to-host 
              Maximum  number of concurrent connection to a given
              host.  (default: 2)


       -retries 
              Number of retries.  (default: 3)


       -receive-timeout 
              Timeout on receive.  (default: 120)


       -unrestartable-receive-timeout 
              Timeout on non restartable connections.   (default:
              600)


       -format-cache-size 
              Number   of   formatted   document   pages  cached.
              (default: 5)


       -memory-cache-size 
              Cache memory in Kilobytes.  (default: 1024)


       -http-proxy 
              Host and port number of the HTTP proxy,  or  blank.
              (default: blank)


       -ftp-proxy 
              Host  and  port  number of the FTP proxy, or blank.
              (default: blank)


       -download-dir 
              Default download directory.  (default: actual dir)


       -assume-codepage 
              Use the given codepage when  the  webpage  did  not
              specify its codepage. (default: ISO 8859-1)


       -anonymous
              Restrict  links  so that it can run on an anonymous
              account.  No local  file  browsing.  No  downloads.
              Executing of viewers is allowed, but user can't add
              or modify entries in association table.


       -no-connect
              Runs links as a separate instance - instead of con-
              necting to existing instance.


       -version
              Prints the links version number and exit.


       -help  Printf a help screen


       More options can be seen with links -h


NAVIGATION KEYS
       The keys you may use while navigating are

       PGDN   page down

       Space  page down

       PGUP   page up

       b      page up

       B      page up

       CursorDOWN
              next  link/down  (text mode), scroll down (graphics
              mode)

       CursorUP
              prev link/up (text mode), up (graphics mode)

       ^INS   copy to clipboard

       ^C     copy to clipboard (OS/2 only)

       INS    scroll up (text mode only)

       ^P     scroll up

       DEL    scroll down

       ^N     scroll down

       [      scroll left

       ]      scroll right

       HOME   home

       END    end of page

       CursorRIGHT
              enter link/press button (text mode),  scroll  right
              (graphics mode)

       ENTER  enter link/press button

       CursorLEFT
              go back (text mode), scroll left (graphics mode)

       d      download link (text mode only)

       D      download link (text mode only)

       /      search in the page

       ?      search back in the page

       n      find next match

       N      find next match backwards

       f      zoom actual frame

       F      zoom actual frame

       ^R     reload page

       g      go to URL

       G      edit the current URL and goto the result

       s      bookmark manager

       S      bookmark manager

       q      quit, close window if more windows are open

       Q      quit, close window if more windows are open

       =      document informations

       \      toggle HTML source/rendered view

       TAB    next frame (text mode only)

       ESC    menu/escape

       F9     menu

       F10    file menu


EDITING KEYS
       The  following keys can be used while editing a line/jump-
       ing to a URL:

       CursorRIGHT
              move right

       CursorLEFT
              move left

       HOME   jump at the beginning

       ^A     jump at the beginning

       END    jump at the end

       ^E     jump at the end

       ^X     cut to clipboard

       ^V     paste from clipboard

       ENTER  enter line

       BACKSPACE
              delete back character

       ^H     delete back character

       DEL    delete character

       ^D     delete character

       ^U     delete from beginning of the line

       ^K     delete to the end of the line or  delete  line  (in
              textarea)

       ^W     auto complete line






FILES
       ~/.links/links.cfg
              Per-user  configfile,  automatically created
              by links.

PLATFORMS
       links is known to work on Linux, FreeBSD,  Solaris,
       IRIX,  HPUX,  Digital  Unix, AIX, Interix, OS/2 and
       BeOS.  Port for Win32 is in state of beta  testing.

BUGS
       You  can't  upload  large files; it takes _lots_ of
       memory.

       Please report any other bugs you  find  to  Mikulas
       Patocka 


LICENSE
       links  is  free  software;  you can redistribute it
       and/or modify it under the terms of the GNU General
       Public  License  as  published by the Free Software
       Foundation; either version 2 of the License, or (at
       your option) any later version.


AUTHOR
       links was written by Mikulas Patocka, Karel 'Clock'
       Kulhavy, Petr 'Brain' Kulhavy,  and  Martin  'PerM'
       Pergel.  See file AUTHORS for a list of people con-
       tributing to this project.

       The   homepage   of   links   can   be   found   at
       http://atrey.karlin.mff.cuni.cz/~clock/twib-
       right/links

       This  manual  page  was  written  by  Peter  Gervai
       ,  using  excerpts  from  a  (yet?)
       unknown links fan for the Debian  GNU/Linux  system
       (but  may be used by others). Updated by Karel Kul-
       havy.


SEE ALSO
       lynx(1), w3m(1)



                            Dec, 2000                    LINKS(1)