Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gophfilt(1) [debian man page]

GOPHFILT(1)						      General Commands Manual						       GOPHFILT(1)

gophfilt - oneshot connection to gopher document server SYNOPSIS
gophfilt [-t type] [-p path] [-h host] [-s port] [-i item] DESCRIPTION
The gophfilt program is a oneshot command line driven version of a gopher client, suitable for use in shell- or awk-scripts. The Internet Gopher is a distributed document delivery service. It allows a neophyte user to access various types of data residing on mul- tiple hosts in a seamless fashion. This is accomplished by presenting the user a hierarchical arrangement of documents and by using a client-server communications model. The Internet Gopher Server accepts simple queries, and responds by sending the client a document. Gophfilt can operate in either of two modes. The first one is in the spirit of unix filters, in that it accepts requests on stdin and writes results to stdout. The request is in the form of a tab-delimited .cache item. For example: 1Master Gopher at UMN 1/ 70 (Or in string notation) "1Master Gopher at UMN 1/ 70 " This example would result in the retrieval of the root directory from the Master Gopher. Gophfilt's other mode permits the construction of a gopher request from arguments provided on the command line. In this "manual" mode, at least the path and type items must be provided. The default host and port are taken from the file conf.h at module build time. -p specifies the path to the requested data. From our "filter" example above, the field "1/" is the path. -t specifies the type of the requested data. From our example above, the leading "1" character is the type (directory, in this case). -h specifies the name of the host where the server is to be found. The default host (CLIENT1_HOST from file conf.h) is used if not pro- vided. -s specifies the service (port) that the server is monitoring. The default port (CLIENT1_PORT from file conf.h) is used if not provided. -i specifies a search item. This field immediately follows the path field in the transmitted request. -T specifies a receiver timeout in seconds. This is the maximum time that gophfilt will wait for more data. If the "timeout" return value is noticed by the calling program, any data received to that point should be considered suspect. To recreate using manual operation the request from our example, one would execute the following command. gophfilt -t 1 -p 1/ -h -s 70 MORE EXAMPLES
Here is an example that demonstrates the usefulness of the gophfilt. This specific example only works on the Rutgers campus, but illus- trates the point gophfilt -t 0 -p "webster default SPELL" -i flatulence -h -s 770 | gophfilt This example requests a selector item from the Webster's Dictionary, and then pipes that item to gophfilt for subsequent retrieval of the actual definition. The result is available on stdout for use. RETURNS
Gophfilt returns the following completion codes on exit: 0 Successful completion. -1 Error in parsing command line arguments. -2 Manual operation and insufficient parameters were provided. -3 Piped operation and unable to read selector from stdin. -4 Unsupported item type requested. -5 Unable to connect to specified host and port combination. -6 Error encountered writing to stdout. -7 Timeout occurred while waiting for more data. GOPHFILT(1)

Check Out this Related Man Page

Regexp::Common::URI::gopher(3)				User Contributed Perl Documentation			    Regexp::Common::URI::gopher(3)

Regexp::Common::URI::gopher -- Returns a pattern for gopher URIs. SYNOPSIS
use Regexp::Common qw /URI/; while (<>) { /$RE{URI}{gopher}/ and print "Contains a gopher URI. "; } DESCRIPTION
$RE{URI}{gopher}{-notab} Gopher URIs are poorly defined. Originally, RFC 1738 defined gopher URIs, but they were later redefined in an internet draft. One that was expired in June 1997. The internet draft for gopher URIs defines them as follows: "gopher:" "//" host [ ":" port ] "/" gopher-type selector [ "%09" search [ "%09" gopherplus_string ]] Unfortunally, a selector is defined in such a way that characters may be escaped using the URI escape mechanism. This includes tabs, which escaped are %09. Hence, the syntax cannot distinguish between a URI that has both a selector and a search part, and an URI where the selector includes an escaped tab. (The text of the draft forbids tabs to be present in the selector though). $RE{URI}{gopher} follows the defined syntax. To disallow escaped tabs in the selector and search parts, use $RE{URI}{gopher}{-notab}. There are other differences between the text and the given syntax. According to the text, selector strings cannot have tabs, linefeeds or carriage returns in them. The text also allows the entire gopher-path, (the part after the slash following the hostport) to be empty; if this is empty the slash may be omitted as well. However, this isn't reflected in the syntax. Under "{-keep}", the following are returned: $1 The entire URI. $2 The scheme. $3 The host (name or address). $4 The port (if any). $5 The "gopher-path", the part after the / following the host and port. $6 The gopher-type. $7 The selector. (When no "{-notab}" is used, this includes the search and gopherplus_string, including the separating escaped tabs). $8 The search, if given. (Only when "{-notab}" is given). $9 The gopherplus_string, if given. (Only when "{-notab}" is given). head1 REFERENCES [RFC 1738] Berners-Lee, Tim, Masinter, L., McCahill, M.: Uniform Resource Locators (URL). December 1994. [RFC 1808] Fielding, R.: Relative Uniform Resource Locators (URL). June 1995. [GOPHER URL] Krishnan, Murali R., Casey, James: "A Gopher URL Format". Expired Internet draft draft-murali-url-gopher. December 1996. SEE ALSO
Regexp::Common::URI for other supported URIs. AUTHOR
Damian Conway ( MAINTAINANCE
This package is maintained by Abigail ( BUGS AND IRRITATIONS
Bound to be plenty. LICENSE and COPYRIGHT This software is Copyright (c) 2001 - 2009, Damian Conway and Abigail. This module is free software, and maybe used under any of the following licenses: 1) The Perl Artistic License. See the file COPYRIGHT.AL. 2) The Perl Artistic License 2.0. See the file COPYRIGHT.AL2. 3) The BSD Licence. See the file COPYRIGHT.BSD. 4) The MIT Licence. See the file COPYRIGHT.MIT. perl v5.18.2 2013-03-08 Regexp::Common::URI::gopher(3)
Man Page

Featured Tech Videos