Penguin
Annotated edit history of links(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 LINKS
2 !!!LINKS
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 NAVIGATION KEYS
8 EDITING KEYS
9 ENVIRONMENT
10 FILES
11 PLATFORMS
12 BUGS
13 LICENSE
14 AUTHOR
15 SEE ALSO
16 ----
17 !!NAME
18
19
20 links - lynx-like alternative character mode WWW browser
21 !!SYNOPSIS
22
23
24 __links__ ''[[options] URL''
25 !!DESCRIPTION
26
27
28 __links__ is a text mode WWW browser, supporting colors,
29 correct table rendering, background downloading, menu driven
30 configuration interface and slim code.
31
32
33 Frames are supported. You can have different file formats
34 associated with external viewers. mailto: and telnet: are
35 supported via external clients.
36
37
38 ''links'' can handle local (file://) or remote (http://,
39 ftp:// or https:// if there's compiled-in SSL support)
40 URLs.
41 !!OPTIONS
42
43
44 Most options can be set in the user interface or config
45 file, so usually you do not need to care about
46 them.
47
48
49 __-anonymous__
50
51
52 Restrict links so that it can run on an anonymous account.
53 No local file browsing. No downloads. Executing of viewers
54 is allowed, but user can't add or modify entries in
55 association table.
56
57
58 __-assume-codepage__ ''''
59
60
61 Use the given codepage when the webpage did not specify its
62 codepage. (default: ISO 8859-1)
63
64
65 __-async-dns__ ''''
66
67
68 Asynchronous DNS resolver on(1)/off(0). Default is
69 on.
70
71
72 __-base-session__ ''''
73
74
75 Linkses are connecting together, forming sessions by
76 default. Normally, there's only one session with number 0.
77 In this way, you can make him to form more sessions at once.
78 See also __-no-connect__ option.
79
80
81 __-download-dir__ ''''
82
83
84 Default download directory. (default: actual
85 dir)
86
87
88 __-download-utime__
89 ''''
90
91
92 Set time of download files on(1)/off(0). Default is
93 off.
94
95
96 __-dump__
97
98
99 Write a plain-text version of the given HTML document to
100 stdout.
101
102
103 __-fake-referer__ ''''
104
105
106 Send always this HTTP referer. Has a mean only with
107 __-http-referer__ ''3''.
108
109
110 __-format-cache-size__ ''''
111
112
113 Number of formatted document pages cached. (default:
114 5)
115
116
117 __-ftp.anonymous-password__
118 ''''
119
120
121 Use this as the password for anonymous ftp
122 sites.
123
124
125 __-ftp-proxy__ ''''
126
127
128 Host and port number of the FTP proxy, or blank. (default:
129 blank)
130
131
132 __-help__
133
134
135 Print a help screen.
136
137
138 __-http-bugs.http10__
139 ''''
140
141
142 Turn use of HTTP/1.0 on(1)/off(0). Default is
143 off.
144
145
146 __-http-bugs.allow-blacklist__
147 ''''
148
149
150 Turn blacklist of buggy servers on(1)/off(0). Default is
151 on.
152
153
154 __-http-bugs.bug-302-redirect__
155 ''''
156
157
158 Turn broken redirect 302 (violates RFC, but compatible with
159 Netscape) on(1)/off(0). Default is off.
160
161
162 __-http-bugs.bug_post-no-keepalive__
163 ''''
164
165
166 Turn no keepalive connection after POST request (for some
167 buggy PHP databases) on(1)/off(0). Default is
168 off.
169
170
171 __-http-proxy__ ''''
172
173
174 Host and port number of the HTTP proxy, or blank. (default:
175 blank)
176
177
178 __-http-referer__
179 ''''
180
181
182 Turn sending of HTTP referer. Either never(0), true(1), same
183 URL(2) or fake(3). (default: none)
184
185
186 __-language__ ''''
187
188
189 Language to use in user interface.
190
191
192 __-max-connections__ ''''
193
194
195 Maximum number of concurrent connections. (default:
196 10)
197
198
199 __-max-connections-to-host__
200 ''''
201
202
203 Maximum number of concurrent connection to a given host.
204 (default: 2)
205
206
207 __-memory-cache-size__ ''''
208
209
210 Cache memory in Kilobytes. (default: 1024)
211
212
213 __-no-connect__
214
215
216 Runs links as a separate instance - instead of connecting to
217 existing instance. Prevents him to connecting to an existing
218 session. See also __-base-session__ option.
219
220
221 __-receive-timeout__ ''''
222
223
224 Timeout on receive. (default: 120)
225
226
227 __-retries__ ''''
228
229
230 Number of retries. (default: 3)
231
232
233 __-source__
234
235
236 Write the given HTML document in source form to
237 stdout.
238
239
240 __-unrestartable-receive-timeout__
241 ''''
242
243
244 Timeout on non restartable connections. (default:
245 600)
246
247
248 __-user-agent__
249
250
251 Change the User Agent. That means identification string,
252 which is sent to HTTP server, when a document is requested.
253 Default is
254
255
256 __-version__
257
258
259 Print the ''links'' version number and exit.
260 !!NAVIGATION KEYS
261
262
263 You may optionally prefix each of this keys with a number,
264 telling its repeat count (how much times to do it). You can
265 also re-bind those keys. See linkskeys(5) for
266 complete documentation about keybindings and more complete
267 list of keys bound by default. The keys you may use for
268 navigation are:
269
270
271 __PGDN__
272
273
274 page down
275
276
277 __Space__
278
279
280 page down
281
282
283 __PGUP__
284
285
286 page up
287
288
289 __b__
290
291
292 page up
293
294
295 __B__
296
297
298 page up
299
300
301 __CursorDOWN__
302
303
304 next link/down
305
306
307 __CursorUP__
308
309
310 prev link/up
311
312
313 __^INS__
314
315
316 copy to clipboard
317
318
319 __^C__
320
321
322 copy to clipboard
323
324
325 __INS__
326
327
328 scroll up
329
330
331 __^P__
332
333
334 scroll up
335
336
337 __DEL__
338
339
340 scroll down
341
342
343 __^N__
344
345
346 scroll down
347
348
349 __[[__
350
351
352 scroll left
353
354
355 __]__
356
357
358 scroll right
359
360
361 __HOME__
362
363
364 home
365
366
367 __END__
368
369
370 end of page
371
372
373 __CursorRIGHT__
374
375
376 enter link/press button
377
378
379 __ENTER__
380
381
382 enter link/press button
383
384
385 __CursorLEFT__
386
387
388 go back
389
390
391 __d__
392
393
394 download link
395
396
397 __D__
398
399
400 download link
401
402
403 __F4__
404
405
406 edit textarea in external editor (broken)
407
408
409 __^T__
410
411
412 edit textarea in external editor (broken)
413
414
415 __/__
416
417
418 search in the page
419
420
421 __?__
422
423
424 search back in the page
425
426
427 __n__
428
429
430 find next match
431
432
433 __N__
434
435
436 find next match backwards
437
438
439 __f__
440
441
442 zoom actual frame
443
444
445 __F__
446
447
448 zoom actual frame
449
450
451 __^R__
452
453
454 reload page
455
456
457 __g__
458
459
460 go to URL
461
462
463 __G__
464
465
466 go to the current URL
467
468
469 __a__
470
471
472 add a new bookmark
473
474
475 __A__
476
477
478 add a new bookmark
479
480
481 __s__
482
483
484 bookmark manager
485
486
487 __S__
488
489
490 bookmark manager
491
492
493 __^K__
494
495
496 reload cookies from ~/.links/cookies
497
498
499 __q__
500
501
502 quit
503
504
505 __Q__
506
507
508 quit
509
510
511 __=__
512
513
514 document information
515
516
517 __|__
518
519
520 header information
521
522
523 __\__
524
525
526 toggle HTML source/rendered view
527
528
529 __*__
530
531
532 toggle display of images
533
534
535 __TAB__
536
537
538 next frame
539
540
541 __ESC__
542
543
544 menu/escape
545
546
547 __F9__
548
549
550 menu
551
552
553 __F10__
554
555
556 file menu
557 !!EDITING KEYS
558
559
560 The following keys can be used while editing a line/jumping
561 to a URL:
562
563
564 __CursorRIGHT__
565
566
567 move right
568
569
570 __CursorLEFT__
571
572
573 move left
574
575
576 __HOME__
577
578
579 jump to the beginning
580
581
582 __^A__
583
584
585 jump to the beginning
586
587
588 __END__
589
590
591 jump to the end
592
593
594 __^E__
595
596
597 jump to the end
598
599
600 __^INS__
601
602
603 copy to clipboard
604
605
606 __^B__
607
608
609 copy to clipboard
610
611
612 __^X__
613
614
615 cut to clipboard
616
617
618 __^V__
619
620
621 paste from clipboard
622
623
624 __ENTER__
625
626
627 enter line
628
629
630 __BACKSPACE__
631
632
633 delete back character
634
635
636 __^H__
637
638
639 delete back character
640
641
642 __DEL__
643
644
645 delete character
646
647
648 __^D__
649
650
651 delete character
652
653
654 __^U__
655
656
657 delete from beginning of the line
658
659
660 __^K__
661
662
663 delete to the end of the line
664
665
666 __^W__
667
668
669 auto complete line
670 !!ENVIRONMENT
671
672
673 CONFIG_DIR
674
675
676 The location of
677
678
679 WWW_HOME
680
681
682 Homepage location (as in __lynx__ )
683
684
685 LINKS_XTERM
686
687
688 The command to run when selecting
689 DISPLAY__ is defined (default
690 __
691
692
693 LINKS_TWTERM
694
695
696 The command to run when selecting
697 TWDISPLAY__ is defined (default
698 __
699
700
701 SHELL
702
703
704 Used for
705
706
707 COMSPEC
708
709
710 Used for
711 !!FILES
712
713
714 ~/.links/links.cfg
715
716
717 Per-user config file, automatically created by __links.__
718 Its format is same as the one of
719 ''user.cfg.''
720
721
722 ~/.links/html.cfg
723
724
725 Per-user config file, automatically created by __links.__
726 It contains HTML rendering options. Its format is same as
727 the one of ''user.cfg.''
728
729
730 ~/.links/user.cfg
731
732
733 Per-user config file, not overwritten while saving
734 __links__ configuration. You can add your own options
735 there (e.g. keybindings). Each line consists from option
736 name (same as the command-line one, but without leading dash
737 and with dashes converted to underscores), space, and its
738 value, in quotes if it's a string. Lines which start with #
739 are considered as comments and skipped.
740
741
742 ~/.links/bookmarks
743
744
745 Bookmarks file
746
747
748 ~/.links/cookies
749
750
751 Cookies file
752
753
754 ~/.links/links.his
755
756
757 Sites history file
758
759
760 ~/.links/socket
761
762
763 Internal links socket for communication between its
764 instances.
765 !!PLATFORMS
766
767
768 __links__ is known to work on Linux, FreeBSD, OpenBSD,
769 Solaris, IRIX, HPUX, Digital Unix, AIX, OS/2, BeOS and RISC
770 OS. Port for Win32 is in state of beta testing.
771 !!BUGS
772
773
774 Can't connect to some FTP servers (Novell, NT). Connection
775 stays in
776
777
778 Frames don't work if there're more frames with same name.
779 Turn them off in such case.
780
781
782 You can't upload large files; it takes _lots_ of
783 memory.
784
785
786 You shouldn't press '^Z' when you are in a
787 viewer
788
789
790 Please report any other bugs you find to __Mikulas Patocka
791 __ or to __links
792 mailing list
793 __
794 !!LICENSE
795
796
797 __links__ is free software; you can redistribute it
798 and/or modify it under the terms of the GNU General Public
799 License as published by the Free Software Foundation; either
800 version 2 of the License, or (at your option) any later
801 version.
802 !!AUTHOR
803
804
805 ''links'' was written by __Mikulas Patocka
806 __ See file
807 ''AUTHORS'' in the source tree for a list of people
808 contributing to this project.
809
810
811 The homepage of links can be found at
812 __http://links.browser.org/__
813
814
815 This manual page was written by Peter Gervai
816 links'' fan for the Debian GNU/Linux system (but may be
817 used by others). Contributions from Francis A. Holop.
818 Extended, clarified and made more up-to-date by Petr Baudis
819 ''
820 !!SEE ALSO
821
822
2 perry 823 linkskeys(5), lynx(1), w3m(1),
1 perry 824 wget(1)
825 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.