links.1 (12524B)
1 .TH LINKS 1 links\-VERSION 2 .SH NAME 3 links \- lynx-like alternative character mode WWW browser 4 .SH SYNOPSIS 5 .B links 6 .I "[options] URL" 7 .SH DESCRIPTION 8 .B links 9 is a text mode WWW browser with ncurses interface, supporting 10 colors, correct table rendering, background downloading, menu 11 driven configuration interface and slim code. 12 .P 13 Frames are supported. You can have different file formats 14 associated with external viewers. 15 .P 16 .I links 17 can handle local (file://) or remote (http://) URLs. 18 .PP 19 20 .SH OPTIONS 21 Most options can be set in the user 22 interface or config file, so usually you do not need to care about them. 23 24 .TP 25 \f3-help\f1 26 Print a help screen 27 28 .TP 29 \f3-version\f1 30 Prints the 31 .I links 32 version number and exit. 33 34 .TP 35 \f3-force-html\f1 36 Treat files with unknown type as html rather than text. 37 (can be toggled with '\\' key) 38 39 .TP 40 \f3-source \f2<url>\f1 41 Write unformatted data stream to stdout. 42 43 .TP 44 \f3-dump \f2<url>\f1 45 Write formatted document to stdout. 46 47 .TP 48 \f3-width \f2<number>\f1 49 For dump, document will be formatted to this screen width (but it can still 50 exceed it if lines can't be broken). 51 52 .TP 53 \f3-anonymous\f1 54 Restrict links so that it can run on an anonymous account. 55 No local file browsing. No downloads. Executing of viewers 56 is allowed, but user can't add or modify entries in 57 association table. 58 59 .TP 60 \f3-no-connect\f1 61 Runs links as a separate instance - instead of connecting to 62 existing instance. 63 64 .TP 65 \f3-download-dir \f2<path>\f1 66 Default download directory. 67 (default: actual dir) 68 69 .TP 70 \f3-language \f2<language>\f1 71 Set user interface language. 72 73 .TP 74 \f3-max-connections \f2<max>\f1 75 Maximum number of concurrent connections. 76 (default: 10) 77 78 .TP 79 \f3-max-connections-to-host \f2<max>\f1 80 Maximum number of concurrent connection to a given host. 81 (default: 2) 82 83 .TP 84 \f3-retries \f2<retry>\f1 85 Number of retries. 86 (default: 3) 87 88 .TP 89 \f3-receive-timeout \f2<sec>\f1 90 Timeout on receive. 91 (default: 120) 92 93 .TP 94 \f3-unrestartable-receive-timeout \f2<sec>\f1 95 Timeout on non restartable connections. 96 (default: 600) 97 98 .TP 99 \f3-timeout-when-trying-multiple-addresses \f2<sec>\f1 100 Timeout for connection when trying multiple addresses or when resuming a keepalive connection. 101 (default: 3) 102 103 .TP 104 \f3-bind-address \f2<ip address>\f1 105 Use a specific local IP address. 106 107 .TP 108 \f3-bind-address-ipv6 \f2<ipv6 address>\f1 109 Use a specific local IPv6 address. 110 111 .TP 112 \f3-no-libevent\f1 113 Don't use libevent library. 114 115 .TP 116 \f3-download-utime \f2<0>/<1>\f1 117 Set time of downloaded files to last modification time reported by server. 118 119 .TP 120 \f3-format-cache-size \f2<num>\f1 121 Number of formatted document pages cached. 122 (default: 5) 123 124 .TP 125 \f3-memory-cache-size \f2<bytes>\f1 126 Cache memory in bytes. 127 (default: 1048576) 128 129 .TP 130 \f3-image-cache-size \f2<bytes>\f1 131 Cache memory in bytes. 132 (default: 1048576) 133 134 .TP 135 \f3-font-cache-size \f2<bytes>\f1 136 Cache memory in bytes. 137 (default: 2097152) 138 139 .TP 140 \f3-aggressive-cache \f2<0>/<1>\f1 141 Always cache everything regardless of server's caching recomendations. 142 Many servers deny caching even if their content is not changing 143 just to get more hits and more money from ads. 144 145 .TP 146 \f3-address-preference \f2<0>/<1>/<2>/<3>/<4>\f1 147 (default 0) 148 0 - use system default. 149 1 - prefer IPv4. 150 2 - prefer IPv6. 151 3 - use only IPv4. 152 4 - use only IPv6. 153 154 .TP 155 \f3-http-proxy \f2<host:port>\f1 156 Host and port number of the HTTP proxy, or blank. 157 (default: blank) 158 159 .TP 160 \f3-https-proxy \f2<host:port>\f1 161 Host and port number of the HTTPS proxy, or blank. 162 (default: blank) 163 164 .TP 165 \f3-socks-proxy \f2<user@host:port>\f1 166 Userid, host and port of Socks4a, or blank. 167 (default: blank) 168 169 .TP 170 \f3-append-text-to-dns-lookups \f2<text>\f1 171 Append text to dns lookups. It is useful for specifying fixed tor exit node. 172 (default: blank) 173 174 .TP 175 \f3-no-proxy-domains \f2<domain,domain...>\f1 176 No proxy for specified domains. 177 (default: blank) 178 179 .TP 180 \f3-only-proxies \f2<0>/<1>\f1 181 "1" causes that Links won't initiate any non-proxy connection. 182 It is useful for anonymization with tor or similar networks. 183 184 .TP 185 \f3-ssl.certificates \f2<0>/<1>/<2>\f1 186 (default 1) 187 0 - ignore invalid certificate. 188 1 - warn on invalid certificate. 189 2 - reject invalid certificate. 190 191 .TP 192 \f3-ssl.builtin-certificates \f2<0>/<1>\f1 193 (default 0; on DOS and OpenVMS default 1) 194 Use built-in certificates instead of system certificates. 195 196 .TP 197 \f3-ssl.client-cert-key \f2<filename>\f1 198 Name of the PEM encoded file with the user private key for client certificate authentication. 199 200 .TP 201 \f3-ssl.client-cert-crt \f2<filename>\f1 202 Name of the PEM encoded file with the user certificate for client certificate authentication. 203 204 .TP 205 \f3-ssl.client-cert-password \f2<text>\f1 206 Password for the user private key. 207 208 .TP 209 \f3-http-bugs.http10 \f2<0>/<1>\f1 210 (default 0) "1" forces using only HTTP/1.0 protocol. (useful for buggy servers 211 that claim to be HTTP/1.1 compliant but are not) 212 "0" enables using both HTTP/1.0 and HTTP/1.1. 213 214 .TP 215 \f3-http-bugs.allow-blacklist \f2<0>/<1>\f1 216 (default 1) 217 "1" defaults to using list of servers that have broken HTTP/1.1 support. 218 When links finds such server, it will retry the request with HTTP/1.0. 219 220 .TP 221 \f3-http-bugs.bug-no-accept-charset \f2<0>/<1>\f1 222 (default 0) 223 Do not send Accept-Charset field of HTTP header. Because it is too long 224 some servers will deny the request. Other servers will convert content 225 to plain ascii when Accept-Charset is missing. 226 227 .TP 228 \f3-http-bugs.no-compression \f2<0>/<1>\f1 229 (default 0) "1" causes that links won't advertise HTTP compression support (but 230 it will still accept compressed data). Use it when you communicate with server 231 that has broken compression support. 232 233 .TP 234 \f3-http-bugs.retry-internal-errors \f2<0>/<1>\f1 235 (default 0) 236 Retry on internal server errors (50x). 237 238 .TP 239 \f3-http.fake-firefox \f2<0>/<1>\f1 240 (default 0) 241 Fake that the browser is Firefox in the HTTP header. 242 243 .TP 244 \f3-http.fake-referer \f2<string>\f1 245 Fake referer value. 246 247 .TP 248 \f3-http.fake-user-agent \f2<string>\f1 249 Fake user agent value. 250 251 .TP 252 \f3-http.extra-header \f2<string>\f1 253 Extra string added to HTTP header. 254 255 .TP 256 \f3-menu-font-size \f2<size>\f1 257 Size of font in menu. 258 259 .TP 260 \f3-menu-background-color \f20xRRGGBB\f1 261 Set menu background color in graphics mode. RRGGBB are hex. 262 263 .TP 264 \f3-menu-foreground-color \f20xRRGGBB\f1 265 Set menu foreground color in graphics mode. RRGGBB are hex. 266 267 .TP 268 \f3-scroll-bar-area-color \f20xRRGGBB\f1 269 Set color of scroll bar area. RRGGBB are hex. 270 271 .TP 272 \f3-scroll-bar-bar-color \f20xRRGGBB\f1 273 Set color of scroll bar. RRGGBB are hex. 274 275 .TP 276 \f3-scroll-bar-frame-color \f20xRRGGBB\f1 277 Set color of scroll bar frame. RRGGBB are hex. 278 279 .TP 280 \f3-bookmarks-file \f2<file>\f1 281 File to store bookmarks. 282 283 .TP 284 \f3-save-url-history \f2<0>/<1>\f1 285 Save URL history on exit. 286 287 .TP 288 \f3-display-red-gamma \f2<fp-value>\f1 289 Red gamma of display. (default 2.2) 290 291 .TP 292 \f3-display-green-gamma \f2<fp-value>\f1 293 Green gamma of display. (default 2.2) 294 295 .TP 296 \f3-display-blue-gamma \f2<fp-value>\f1 297 Blue gamma of display. (default 2.2) 298 299 .TP 300 \f3-user-gamma \f2<fp-value>\f1 301 Additional gamma. (defult 1) 302 303 .TP 304 \f3-bfu-aspect \f2<fp-value>\f1 305 Display aspect ration. 306 307 .TP 308 \f3-dither-letters \f2<0>/<1>\f1 309 Do letter dithering. 310 311 .TP 312 \f3-dither-images \f2<0>/<1>\f1 313 Do image dithering. 314 315 .TP 316 \f3-gamma-correction \f2<0>/<1>/<2>\f1 317 Type of gamma correction: 318 (default 2) 319 0 - 8-bit (fast). 320 1 - 16-bit (slow). 321 2 - automatically detect according to speed of FPU. 322 323 .TP 324 \f3-overwrite-instead-of-scroll \f2<0>/<1>\f1 325 Overwrite the screen instead of scrolling it 326 (valid for svgalib and framebuffer). 327 Overwriting may or may not be faster, depending on hardware. 328 329 .TP 330 \f3-html-assume-codepage \f2<codepage>\f1 331 Use the given codepage when the webpage did not specify 332 its codepage. (default: ISO 8859-1) 333 334 .TP 335 \f3-html-hard-assume \f2<0>/<1>\f1 336 Use always character set from "\-html-assume-codepage" no matter 337 what server sent. 338 339 .TP 340 \f3-html-tables \f2<0>/<1>\f1 341 Render tables. (0) causes tables being rendered like in lynx. 342 343 .TP 344 \f3-html-frames \f2<0>/<1>\f1 345 Render frames. (0) causes frames rendered like in lynx. 346 347 .TP 348 \f3-html-break-long-lines \f2<0>/<1>\f1 349 Break long lines in <pre> sections. 350 351 .TP 352 \f3-html-images \f2<0>/<1>\f1 353 Display links to unnamed images as [IMG] 354 355 .TP 356 \f3-html-image-names \f2<0>/<1>\f1 357 Display filename of an image instead of [IMG]. 358 359 .TP 360 \f3-html-display-images \f2<0>/<1>\f1 361 Display images in graphics mode. 362 363 .TP 364 \f3-html-image-scale \f2<percent>\f1 365 Scale images in graphics mode. 366 367 .TP 368 \f3-html-bare-image-autoscale \f2<0>/<1>\f1 369 Autoscale images displayed in full screen. 370 371 .TP 372 \f3-html-numbered-links \f2<0>/<1>\f1 373 Number links in text mode. Allow quick link selection by typing 374 link number and enter. 375 376 .TP 377 \f3-html-table-order \f2<0>/<1>\f1 378 In text mode, walk through table by rows (0) or columns (1). 379 380 .TP 381 \f3-html-auto-refresh \f2<0>/<1>\f1 382 Process refresh to other page (1), or display link to that page (0). 383 384 .TP 385 \f3-html-target-in-new-window \f2<0>/<1>\f1 386 Allow opening new windows from html. 387 388 .TP 389 \f3-html-margin \f2<number of spaces>\f1 390 Margin in text mode. 391 392 .TP 393 \f3-html-user-font-size \f2<size>\f1 394 Size of font on pages in graphics mode. 395 396 .TP 397 \f3-html-text-color \f2<0>-<15>\f1 398 Text color in text mode. 399 400 .TP 401 \f3-html-link-color \f2<0>-<15>\f1 402 Link color in text mode. 403 404 .TP 405 \f3-html-background-color \f2<0>-<7>\f1 406 Background color in text mode. 407 408 .TP 409 \f3-html-ignore-document-color \f2<0>/<1>\f1 410 Ignore colors specified in html document in text mode. 411 412 .TP 413 \f3-html-g-text-color \f20xRRGGBB\f1 414 Text color in graphics mode. 415 416 .TP 417 \f3-html-g-link-color \f20xRRGGBB\f1 418 Link color in graphics mode. 419 420 .TP 421 \f3-html-g-background-color \f20xRRGGBB\f1 422 Background color in graphics mode. 423 424 .TP 425 \f3-html-g-ignore-document-color \f2<0>/<1>\f1 426 Ignore colors specified in html document in graphics mode. 427 428 .PP 429 More options can be seen with links \-h 430 431 .SH NAVIGATION KEYS 432 The keys you may use while navigating are 433 .TP 434 .B ESC 435 menu/escape 436 .TP 437 .B F9 438 menu 439 .TP 440 .B F10 441 file menu 442 .TP 443 .B TAB 444 next frame 445 .TP 446 .B PGDN 447 page down 448 .TP 449 .B Space 450 page down 451 .TP 452 .B PGUP 453 page up 454 .TP 455 .B b 456 page up 457 .TP 458 .B CursorDOWN 459 next link/down 460 .TP 461 .B CursorUP 462 prev link/up 463 .TP 464 .B INS 465 scroll up 466 .TP 467 .B ^P 468 scroll up 469 .TP 470 .B DEL 471 scroll down 472 .TP 473 .B ^N 474 scroll down 475 .TP 476 .B [ 477 scroll left 478 .TP 479 .B ] 480 scroll right 481 .TP 482 .B HOME 483 home 484 .TP 485 .B END 486 end of page 487 .TP 488 .B CursorRIGHT 489 enter link/press button 490 .TP 491 .B ENTER 492 enter link/press button 493 .TP 494 .B CursorLEFT 495 go back 496 .TP 497 .B d 498 download link 499 .TP 500 .B / 501 search in the page 502 .TP 503 .B ? 504 search back in the page 505 .TP 506 .B n 507 find next match 508 .TP 509 .B N 510 find next match backwards 511 .TP 512 .B f 513 zoom actual frame 514 .TP 515 .B ^R 516 reload page 517 .TP 518 .B g 519 go to URL 520 .TP 521 .B G 522 edit the current URL and goto the result 523 .TP 524 .B ^G 525 edit the current link and goto the result 526 .TP 527 .B s 528 bookmark manager 529 .TP 530 .B q 531 quit, close window if more windows are open 532 .TP 533 .B Q 534 quit without asking 535 .TP 536 .B = 537 document information 538 .TP 539 .B \e 540 toggle HTML source/rendered view 541 542 .SH EDITING KEYS 543 The following keys can be used while editing a line/jumping to a URL: 544 .TP 545 .B CursorRIGHT 546 move right 547 .TP 548 .B CursorLEFT 549 move left 550 .TP 551 .B HOME 552 jump at the beginning 553 .TP 554 .B ^A 555 jump at the beginning 556 .TP 557 .B END 558 jump at the end 559 .TP 560 .B ^E 561 jump at the end 562 .TP 563 .B ^X 564 cut to clipboard 565 .TP 566 .B ^B 567 copy to clipboard 568 .TP 569 .B ^V 570 paste from clipboard 571 .TP 572 .B ENTER 573 enter line 574 .TP 575 .B BACKSPACE 576 delete back character 577 .TP 578 .B ^H 579 delete back character 580 .TP 581 .B DEL 582 delete character 583 .TP 584 .B ^D 585 delete character 586 .TP 587 .B ^U 588 delete from beginning of the line 589 .TP 590 .B ^K 591 delete to the end of the line or delete line (in textarea) 592 .TP 593 .B ^W 594 auto complete line 595 596 .SH FILES 597 .TP 598 .IP "~/.links/links.cfg" 599 Per-user configfile, automatically created by 600 .B links. 601 .SH PLATFORMS 602 .B links 603 is known to work on Linux, FreeBSD, Solaris, IRIX, HPUX, Digital Unix, AIX, 604 OS/2, BeOS and Win32. 605 .SH BUGS 606 You can't upload large files; it takes _lots_ of memory. 607 .PP 608 Please report any other bugs you find to Mikulas Patocka 609 <mikulas@artax.karlin.mff.cuni.cz> 610 611 .SH LICENSE 612 .B links 613 is free software; you can redistribute it and/or modify 614 it under the terms of the GNU General Public License as published by 615 the Free Software Foundation; either version 2 of the License, or 616 (at your option) any later version. 617 618 .SH AUTHOR 619 .I links 620 was written by 621 .B Mikulas Patocka, Karel 'Clock' Kulhavy, Petr 'Brain' Kulhavy, and Martin 'PerM' Pergel. 622 See file 623 .I AUTHORS 624 for a list of people contributing to this project. 625 .P 626 The homepage of links can be found at 627 .BI http://links.twibright.com/ 628 .P 629 This manual page was written by Peter Gervai <grin@tolna.net>, 630 using excerpts from a (yet?) unknown 631 .I links 632 fan 633 for the Debian GNU/Linux system (but may be used by others). Updated by Karel Kulhavy. 634 635 .SH "SEE ALSO" 636 .BR lynx (1), 637 .BR w3m (1)