GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
GUTENFETCH(1) FreeBSD General Commands Manual GUTENFETCH(1)

gutenfetch - Retrieve listings and books availiable from project gutenberg.

gutenfetch [options]

-h, --help

Display usage and version.

-D, --debug

If debugging is enabled at compile time, this option will be present and can be used to print all types of useful internal variables to see where things fail.

-V, --version

Display the version of gutenfetch.

-m, --make-config

Force the generation of a new ~/.gutenfetchrc file.

-v, --verbose

Turn on verbose error reporting.

-q, --quiet

Turn off error reporting.

-o <file>
--output=<file>

Direct output to a file, '-' is stdout, stdout is default.

-s <server>
--server=<server>

Force the use of a particular server. The form must be in the form of '[http|ftp]://some.server.name/root/to/gutenberg/books/'

-F, --filter

When listing available books on Project Gutenberg, this option will filter the file GUTINDEX.ALL to display only entries which it thinks are valid etexts. This shrinks the amount of data you have to sift through but you miss out on other comments in the file. The default is to show the whole file, unfiltered.

-C, --clear-filter

When listing available books on Project Gutenberg, this option will prevent gutenfetch from filtering the GUTINDEX.ALL file. This is the default behaviour

-l, --list

List all books availiable on the gutenberg server. Consider using grep on the output to narrow the list such as

gutenfetch -l | grep -i 'alice' | less

to find "Alice in Wonderland" by Lewis Carroll

The entry will look like this.

Jan 1991 Alice in Wonderland, Lewis Carroll [Carroll #1][alicexxx.xxx] 11

The number at the end of the line, in this case 11, is the book id. You need that reference to fetch and download the ascii text version of the book. Some entries have an 'A' after their book id. These are books which are only available from within Australia. You may have trouble fetching these texts unless you live in australia and have an australian server selected. Some entries have a 'C' after their bookid. These books are restricted in some form. Other entries may have an '*' after the bookid. These positions are reserved and the books will arrive soon with any luck.

-f <bookid>
--fetch=<bookid>

Fetch an etext off of the server. To fetch and read "Alice in Wonderland" you would use this command.

gutenfetch -f 11 | less

c, --enable-cache

The cache is enabled by default. This can improve performance by keeping copies of fetched books and indexes on your local disk. Once a book or GUTINDEX.ALL is fetched it remains in the cache for 48 hours at which time, the program will fetch the latest copy of the file from the Project Gutenberg servers.

d, --disable-cache

Prevent gutenfetch from caching files to the disk. If you have a www proxy like squid running, this may be your prefered behaviour.

gutenfetch will return a value of 1 on success and a value of 0 if something went wrong. This could be useful if you are building an application on top of gutenfetch.

gutenfetch is Copyright (c) 2001, 2002, 2003, 2004 Russell Francis.

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

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Nope, ;)

Russell Francis <johntabularasa@users.sf.net>

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.