# These settings control internal lynx behavior - the way it interacts with the # operating system and Internet. Modifying these settings will not change # the rendition of documents that you browse with lynx, but can change various # delays and resource utilization.
# If SAVE_SPACE is defined, it will be used as a path prefix for the
# suggested filename in "Save to Disk" operations from the 'p'rint or
# 'd'ownload menus. On VMS, you can use either VMS (e.g., "SYS$LOGIN:")
# or Unix syntax (including '~' for the HOME directory). On Unix, you
# must use Unix syntax. If the symbol is not defined, or is zero-length
# (""), no prefix will be used, and only a filename for saving in the
# current default directory will be suggested.
# This definition will be overridden if a "LYNX_SAVE_SPACE" environment
# variable has been set on Unix, or logical has been defined on VMS.
#
#SAVE_SPACE:~/foo/
SAVE_SPACE:~/dl/
# Lynx uses temporary files for (among other purposes) the content of # various user interface pages. REUSE_TEMPFILES changes the behavior # for some of these temp files, among them pages shown for HISTORY, # VLINKS, OPTIONS, INFO, PRINT, DOWNLOAD commands. # If set to TRUE, the same file can be used multiple times for the same # purpose. If set to FALSE, a new filename is generated each time before # rewriting such a page. With TRUE, repeated invocation of these commands # is less likely to push previous documents out of the cache of rendered # texts (see also DEFAULT_CACHE_SIZE). This is especially useful with # intermittent (dialup) network connections, when it is desirable to # continue browsing through the cached documents after disconnecting. # With the default setting of FALSE, there can be more than one incarnation # of e.g. the VLINKS page cached in memory (but still only the most recently # generated one is kept as a file), resulting in sometimes less surprising # behaviour when returning to such a page via HISTORY or PREV_DOC functions # (most users will not encounter and notice this difference). # #REUSE_TEMPFILES:FALSE REUSE_TEMPFILES:TRUE
# If LYNX_HOST_NAME is defined here or in userdefs.h, it will be # treated as an alias for the local host name in checks for URLs on # the local host (e.g., when the -localhost switch is set), and this # host name, "localhost", and HTHostName (the fully qualified domain # name of the system on which Lynx is running) will all be passed as # local. A different definition here will override that in userdefs.h. # #LYNX_HOST_NAME:www.cc.ukans.edu
# localhost aliases # Any LOCALHOST_ALIAS definitions also will be accepted as local when # the -localhost switch is set. These need not actually be local, i.e., # in contrast to LYNX_HOST_NAME, you can define them to trusted hosts at # other Internet sites. # # # Examples: #LOCALHOST_ALIAS:gopher.server.domain #LOCALHOST_ALIAS:news.server.domain
# LOCAL_DOMAIN is used for a tail match with the ut_host element of # the utmp or utmpx structure on systems with utmp capabilities, to # determine if a user is local to your campus or organization when # handling -restrictions=inside_foo or outside_foo settings for ftp, # news, telnet/tn3270 and rlogin URLs. An "inside" user is assumed # if your system does not have utmp capabilities. CHANGE THIS here # if it was not changed in userdefs.h at compilation time. # #LOCAL_DOMAIN:ukans.edu
# The DEFAULT_CACHE_SIZE specifies the number of WWW documents to be # cached in memory at one time. # # This so-called cache size (actually, number) is defined in userdefs.h and # may be modified here and/or with the command line argument -cache=NUMBER # The minimum allowed value is 2, for the current document and at least one # to fetch, and there is no absolute maximum number of cached documents. # On Unix, and VMS not compiled with VAXC, whenever the number is exceeded # the least recently displayed document will be removed from memory. # # On VMS compiled with VAXC, the DEFAULT_VIRTUAL_MEMORY_SIZE specifies the # amount (bytes) of virtual memory that can be allocated and not yet be freed # before previous documents are removed from memory. If the values for both # the DEFAULT_CACHE_SIZE and DEFAULT_VIRTUAL_MEMORY_SIZE are exceeded, then # the least recently displayed documents will be freed until one or the other # value is no longer exceeded. The default value is defined in userdefs.h. # # The Unix and VMS (but not VAXC) implementations use the C library malloc's # and calloc's for memory allocation, but procedures for taking the actual # amount of cache into account still need to be developed. They use only # the DEFAULT_CACHE_SIZE value, and that specifies the absolute maximum # number of documents to cache (rather than the maximum number only if # DEFAULT_VIRTUAL_MEMORY_SIZE has been exceeded, as with VAXC/VAX). # #DEFAULT_CACHE_SIZE:10 #DEFAULT_VIRTUAL_MEMORY_SIZE:512000 DEFAULT_CACHE_SIZE:666
# SOURCE_CACHE sets the source caching behavior for Lynx: # FILE causes Lynx to keep a temporary file for each cached document # containing the HTML source of the document, which it uses to regenerate # the document when certain settings are changed (for instance, # historical vs. minimal vs. valid comment parsing) instead of reloading # the source from the network. # MEMORY is like FILE, except the document source is kept in memory. You # may wish to adjust DEFAULT_CACHE_SIZE and DEFAULT_VIRTUAL_MEMORY_SIZE # accordingly. # NONE is the default; the document source is not cached, and is reloaded # from the network when needed. # #SOURCE_CACHE:NONE SOURCE_CACHE:FILE
# This setting controls what will happen with cached source for the document # being fetched from the net if fetching was aborted (either user pressed # 'z' or network went down). If set to KEEP, the source fetched so far will # be preserved (and used as cache), if set to DROP lynx will drop the # source cache for that document (i.e. only completely downloaded documents # will be cached in that case). #SOURCE_CACHE_FOR_ABORTED:DROP SOURCE_CACHE_FOR_ABORTED:KEEP
# If ALWAYS_RESUBMIT_POSTS is set TRUE, Lynx always will resubmit forms # with method POST, dumping any cache from a previous submission of the # form, including when the document returned by that form is sought with # the PREV_DOC command or via the history list. Lynx always resubmits # forms with method POST when a submit button or a submitting text input # is activated, but normally retrieves the previously returned document # if it had links which you activated, and then go back with the PREV_DOC # command or via the history list. # # The default defined here or in userdefs.h can be toggled via # the -resubmit_forms command line switch. # #ALWAYS_RESUBMIT_POSTS:FALSE
# If TRIM_INPUT_FIELDS is set TRUE, Lynx will trim trailing whitespace (e.g., # space, tab, carriage return, line feed and form feed) from the text entered # into form text and textarea fields. Older versions of Lynx do this trimming # unconditionally, but other browsers do not, which would yield different # behavior for CGI scripts. #TRIM_INPUT_FIELDS:FALSE
# MAIL_SYSTEM_ERROR_LOGGING will send a message to the owner of # the information, or ALERTMAIL if there is no owner, every time # that a document cannot be accessed! # # NOTE: This can generate A LOT of mail, be warned. # #MAIL_SYSTEM_ERROR_LOGGING:FALSE
# If CHECKMAIL is set to TRUE, the user will be informed (via a statusline # message) about the existence of any unread mail at startup of Lynx, and # will get statusline messages if subsequent new mail arrives. If a jumps # file with a lynxprog URL for invoking mail is available, or your html # pages include an mail launch file URL, the user thereby can access mail # and read the messages. The checks and statusline reports will not be # performed if Lynx has been invoked with the -restrictions=mail switch. # # VMS USERS !!! # ============= # New mail is normally broadcast as it arrives, via "unsolicited screen # broadcasts", which can be "wiped" from the Lynx display via the Ctrl-W # command. You may prefer to disable the broadcasts and use CHECKMAIL # instead (e.g., in a public account which will be used by people who # are ignorant about VMS). # #CHECKMAIL:FALSE
# If NO_FROM_HEADER is set FALSE, From headers will be sent in transmissions # to http or https servers if the personal_mail_address has been defined via # the 'o'ptions menu. The compilation default is TRUE (no From header is # sent) and the default can be changed here. The default can be toggled at # run time via the -from switch. Note that transmissions of From headers # have become widely considered to create an invasion of privacy risk. # #NO_FROM_HEADER:TRUE
# If NO_REFERER_HEADER is TRUE, Referer headers never will be sent in # transmissions to servers. Lynx normally sends the URL of the document # from which the link was derived, but not for startfile URLs, 'g'oto # URLs, 'j'ump shortcuts, bookmark file links, history list links, or # URLs that include the content from form submissions with method GET. # If left FALSE here, it can be set TRUE at run time via the -noreferer # switch. # #NO_REFERER_HEADER:FALSE
# If NO_FILE_REFERER is TRUE, Referer headers never will be sent in # transmissions to servers for links or actions derived from documents # or forms with file URLs. This ensures that paths associated with # the local file system are never indicated to servers, even if # NO_REFERER_HEADER is FALSE. If set to FALSE here, it can still be # set TRUE at run time via the -nofilereferer switch. # #NO_FILE_REFERER:TRUE
# REFERER_WITH_QUERY controls what happens when the URL in a Referer # header to be sent would contain a query part in the form of a '?' # character followed by one or more attribute=value pairs. Query parts # often contain sensitive or personal information resulting from filling # out forms, or other info that allows tracking of a user's browsing path # through a site, an thus should not be put in a Referer header (which may # get sent to an unrelated third-party site). On the other hand, some # sites (improperly) rely on browsers sending Referer headers, even when # the user is coming from a page whose URL has a query part. # # If REFERER_WITH_QUERY is SEND, full Referer headers will be sent # including the query part (unless sending of Referer is disabled in # general, see NO_REFERER_HEADER above). If REFERER_WITH_QUERY is # PARTIAL, the Referer header will contain a partial URL, with the query # part stripped off. This is not strictly correct, but should satisfy # those sites that check only whether the user arrived at a page from an # "outside" link. If REFERER_WITH_QUERY is set to DROP (or anything else # unrecognized), the default, no Referer header is sent at all in this # situation. # #REFERER_WITH_QUERY:DROP REFERER_WITH_QUERY:PARTIAL
# AUTO_UNCACHE_DIRLISTS determines when local file directory listings are # automatically regenerated (by re-reading the actual directory from disk). # Set the value to 0 to avoid automatic regeneration in most cases. This is # useful for browsing large directories that take some time to read and format. # An update can still always be forced with the RELOAD key, and specific DIRED # actions may cause a refresh anyway. Set the value to 1 to force regeneration # after commands that usually change the directory or some files and would make # the displayed info stale, like EDIT and REMOVE. Set it to 2 (the default) or # greater to force regeneration even after leaving the displayed directory # listing by some action that usually causes no change, like GOTO or entering a # file with the ACTIVATE key. This option is only honored in DIRED mode (i.e. # when lynx is compiled with DIRED_SUPPORT and it is not disabled with a # -restriction). Local directories displayed without DIRED normally act as if # AUTO_UNCACHE_DIRLISTS:0 was in effect. # #AUTO_UNCACHE_DIRLISTS:2
# Some systems only: #=================== # Lynx tries to detect window size changes with a signal handler for # SIGWINCH if supported. If NONRESTARTING_SIGWINCH is set to TRUE, # and the sigaction interface is available on the system, the handler # is installed as 'non-restarting'. On some systems (depending on the # library used for handling keyboard input, e.g. ncurses), this allows # more immediate notification of window size change events. If the value # is set to FALSE, the signal() interface is used; this normally makes # the handler 'restarting', with the effect that lynx can react to size # changes only after some key is pressed. The value can also be set to # XWINDOWS; this is equivalent to TRUE when the user has the environment # variable DISPLAY defined *at program start*, and equivalent to FALSE # otherwise. The non-restarting behavior can also be changed to TRUE # or FALSE with the -nonrestarting_sigwinch switch, which overrides the # value in this file. # # Note that Lynx never re-parses document text purely as a result of a # window size change, so text lines may appear truncated after narrowing # the window, until the document is reloaded with ^R or a similar key # or until a different text is loaded. # # The default is FALSE since there is a possibility that non-restarting # interrupts may be mis-interpreted as fatal input errors in some # configurations (leading to an abrupt program exit), and since this # option is useful mostly only for users running Lynx under xterm or a # similar X terminal emulator. On systems where the preconditions don't # apply this option is ignored. # #NONRESTARTING_SIGWINCH:FALSE NONRESTARTING_SIGWINCH:TRUE
# Unix ONLY: #=========== # If NO_FORCED_CORE_DUMP is set to TRUE, Lynx will not force # core dumps via abort() calls on fatal errors or assert() # calls to check potentially fatal errors. The compilation # default normally is FALSE, and can be changed here. The # compilation or configuration default can be toggled via # the -core command line switch. # Note that this setting cannot be used to prevent core dumps # with certainty. If this is important, means provided by the # operating system or kernel should be used. # #NO_FORCED_CORE_DUMP:FALSE
# CERN-style rules, EXPERIMENTAL - URL-specific rules # # A CERN-style rules file can be given with RULESFILE. Use the system's # native format for filenames, on Unix '~' is also recognized. If a filename # is given, the file must exist. # # Single CERN-style rules can be specified with RULES. # # Both options can be repeated, rules accumulate in the order # given, they will be applied in first-to-last order. See cernrules.txt # in the samples subdirectory for further explanation. # # Examples: # # Examples: # RULESFILE:/etc/lynx/cernrules # RULE:Fail gopher:* # reject by scheme # RULE:Pass finger://*@localhost/ # allow this, # RULE:Fail finger:* # but not others # RULE:Redirect http://old.server/* http://new.server/*
# Set FTP_PASSIVE to TRUE if you want to use passive mode ftp transfers. # You might have to do this if you're behind a restrictive firewall. #FTP_PASSIVE:TRUE FTP_PASSIVE:TRUE
# The forms-based O'ptions menu shows a (!) marker beside items which are not # saved to ~/.lynxrc -- the reason for disabling some of these items is that # they are likely to cause confusion if they are read from the .lynxrc file for # each session. However, they can be enabled or disabled using the # ENABLE_LYNXRC settings. The default (compiled-in) settings are shown below. # The second column is the name by which a setting is saved to .lynxrc (which # is chosen where possible to correspond with lynx.cfg). Use "OFF" to disable # writing a setting, "ON" to enable it. Settings are read from .lynxrc after # the corresponding data from lynx.cfg, so they override lynx.cfg, which is # probably what users expect. # # Note that a few settings (Cookies and Show images) are comprised of more than # one lynx.cfg setting. # #ENABLE_LYNXRC:accept_all_cookies:ON #ENABLE_LYNXRC:assume_charset:OFF #ENABLE_LYNXRC:auto_session:OFF #ENABLE_LYNXRC:bookmark_file:ON #ENABLE_LYNXRC:case_sensitive_searching:ON #ENABLE_LYNXRC:character_set:ON #ENABLE_LYNXRC:cookie_accept_domains:ON #ENABLE_LYNXRC:cookie_file:ON #ENABLE_LYNXRC:cookie_loose_invalid_domains:ON #ENABLE_LYNXRC:cookie_query_invalid_domains:ON #ENABLE_LYNXRC:cookie_reject_domains:ON #ENABLE_LYNXRC:cookie_strict_invalid_domains:ON #ENABLE_LYNXRC:dir_list_style:ON #ENABLE_LYNXRC:display:OFF #ENABLE_LYNXRC:emacs_keys:ON #ENABLE_LYNXRC:file_editor:ON #ENABLE_LYNXRC:file_sorting_method:ON #ENABLE_LYNXRC:force_cookie_prompt:OFF #ENABLE_LYNXRC:force_ssl_prompt:OFF #ENABLE_LYNXRC:ftp_passive:OFF #ENABLE_LYNXRC:kblayout:ON #ENABLE_LYNXRC:keypad_mode:ON #ENABLE_LYNXRC:lineedit_mode:ON #ENABLE_LYNXRC:locale_charset:ON #ENABLE_LYNXRC:make_links_for_all_images:OFF #ENABLE_LYNXRC:make_pseudo_alts_for_inlines:OFF #ENABLE_LYNXRC:multi_bookmark:ON #ENABLE_LYNXRC:personal_mail_address:ON #ENABLE_LYNXRC:preferred_charset:ON #ENABLE_LYNXRC:preferred_encoding:OFF #ENABLE_LYNXRC:preferred_language:ON #ENABLE_LYNXRC:preferred_media_types:OFF #ENABLE_LYNXRC:raw_mode:OFF #ENABLE_LYNXRC:run_all_execution_links:ON #ENABLE_LYNXRC:run_execution_links_on_local_files:ON #ENABLE_LYNXRC:scrollbar:OFF #ENABLE_LYNXRC:select_popups:ON #ENABLE_LYNXRC:session_file:OFF #ENABLE_LYNXRC:set_cookies:OFF #ENABLE_LYNXRC:show_color:ON #ENABLE_LYNXRC:show_cursor:ON #ENABLE_LYNXRC:show_dotfiles:ON #ENABLE_LYNXRC:show_kb_rate:OFF #ENABLE_LYNXRC:sub_bookmarks:ON #ENABLE_LYNXRC:tagsoup:OFF #ENABLE_LYNXRC:underline_links:OFF #ENABLE_LYNXRC:user_mode:ON #ENABLE_LYNXRC:useragent:OFF #ENABLE_LYNXRC:verbose_images:ON #ENABLE_LYNXRC:vi_keys:ON #ENABLE_LYNXRC:visited_links:ON # ENABLE_LYNXRC:assume_charset:ON ENABLE_LYNXRC:force_cookie_prompt:ON ENABLE_LYNXRC:force_ssl_prompt:ON ENABLE_LYNXRC:make_links_for_all_images:ON ENABLE_LYNXRC:make_pseudo_alts_for_inlines:ON ENABLE_LYNXRC:preferred_encoding:ON ENABLE_LYNXRC:preferred_language:ON ENABLE_LYNXRC:preferred_media_types:ON ENABLE_LYNXRC:raw_mode:ON ENABLE_LYNXRC:scrollbar:ON ENABLE_LYNXRC:set_cookies:ON ENABLE_LYNXRC:show_kb_rate:ON ENABLE_LYNXRC:tagsoup:ON ENABLE_LYNXRC:underline_links:ON ENABLE_LYNXRC:auto_session:ON ENABLE_LYNXRC:session_file:ON
# Some ftp servers are known to have a broken implementation of RETR. If asked # to retrieve a directory, they get confused and fails subsequent commands such # as CWD and LIST. Workaround: reconnect after a failed RETR, which is slow. # # Each BROKEN_FTP_RETR gives a string match for the reported FTP server version #BROKEN_FTP_RETR:ProFTPD 1.2.5 #BROKEN_FTP_RETR:spftp/
# Some ftp servers are known to have a broken implementation of EPSV. The # server will hang for a long time when we attempt to connect after issuing # this command. Workaround: do not use EPSV, just use PASV. # # Each BROKEN_FTP_EPSV gives a string match for the reported FTP server version #BROKEN_FTP_EPSV:(Version wu-2.6.2-12)
Prev: Interaction || Next: Keyboard Input