

GOPHER(1)              ConvexOS Man Pages              GOPHER(1)


NNAAMMEE
     gopher - connect to gopher document server

SSYYNNOOPPSSIISS
     ggoopphheerr [-_s_S_b_D_r] [-_t _t_i_t_l_e] [-_p _p_a_t_h] [-_T _t_y_p_e] [-_i _s_e_a_r_c_h
     _t_e_r_m] [_h_o_s_t_n_a_m_e] [_p_o_r_t]

DDEESSCCRRIIPPTTIIOONN
     The gopher client is used to talk to gopher servers.  Once
     you have started the gopher client, help on using it is
     available by pressing the ?? key.

     The Internet Gopher is a distributed document delivery ser-
     vice.  It allows a neophyte user to access various types of
     data residing on multiple hosts in a seamless fashion.  This
     is accomplished by presenting the user a hierarchical
     arrangement of documents and by using a client-server com-
     munications model.  The Internet Gopher Server accepts sim-
     ple queries, and responds by sending the client a document.

     The [hostname] may be specified at startup; if omitted, the
     default server for your site is used.

     The  [Port_number] of the server host may be specified at
     startup; if omitted you will use the default port specified
     at your site.  The more or less standard and accepted Gopher
     port number on the Internet is 70.

OOPPTTIIOONNSS
     -b   starts the client on the bookmark page.

     The next few options are for more advanced users who want to
     start at a location other than the default, or to set up
     special aliases or shell-scripts to point the gopher client
     to seperate places.

     --pp _p_a_t_h
          specify a specific selector string to send to the
          gopher server on startup.

     --TT _t_y_p_e
          let the client know what type of object the -_p option
          is pointing at.

     --ii _s_e_a_r_c_h _t_e_r_m
          tell the client what to search for in the object
          defined by the -_p and -_T _7 options.

     --tt _t_i_t_l_e
          set the title of the initial screen for the gopher
          client.


Printed 7/22/94                                                 1


GOPHER(1)              ConvexOS Man Pages              GOPHER(1)


     The last few options aren't really of interest to regular
     users, but are provided for system administrators who waht
     to provide a secure client, or who need to debug a client.


     --ss or --SS
          "secure mode" which means that you can't save or print
          the files that you browse.  -s is for users without an
          account, while -S assumes the user has an account on
          this machine.  One security feature is forced on,
          regardless of the state of these options, if the name
          of the user's shell ends in rsh; the 'O' (options) com-
          mand is disabled so the user cannot select a shell as
          an application.

     --rr   tells the client that its user is remote.

     --DD   turns on the copius debugging output


IInn--SSeessssiioonn OOppttiioonnss
     Press return or the right arrow key on the mini keypad to
     view a document or enter a directory.


     Press  Control/W, Control/R, or Control/L to repaint your
     menu at any time.


     At  any  time,  you  may  press  ?  to  see  a  help file of
     commands available.


BBOOOOKKMMAARRKKSS
     Bookmarks allow users to create their own personallized
     menus from those available on the variety of Gopher servers
     available worldwide.  The following list of keystrokes aids
     in developing and maintaining the bookmarks.


           a : Add current item to the bookmark list.
           A : Add current directory/search to bookmark list.
           v : View bookmark list.
           d : Delete a bookmark/directory entry.


MMOOVVIINNGG AARROOUUNNDD
     Use the arrow keys to move around.


           Use the Arrow Keys to move around.


Printed 7/22/94                                                 2


GOPHER(1)              ConvexOS Man Pages              GOPHER(1)


           Up, k ...............:  Move to previous line.
           Down, j .............:  Move to next line.
           Right, Return .......:  "Enter"/Display current item.
           Left, u  ............:  "Exit" current item/Go up a
          level.

           >, +, Pgdwn, space ..:  View next page.
           <, -, Pgup, b .......:  View previous page.

           0-9 .................:  Go to a specific line.
           m   .................:  Go back to the main menu.


OOTTHHEERR CCOOMMMMAANNDDSS
           s : Save current item to a file.
           S : Save current list of items to a file.
           D : Download a file.
           q : Quit with prompt.
           Q : Quit unconditionally (also Control/Z).
           r : goto root menu of current item.
           R : goto root menu of current menu.
           = : Display Technical information about current item.
           ^ : Display technical information about current direc-
          tory.
           o : Open a new gopher server
           O : Change options.
           f : Connect to an anonymous FTP host
           / : Search for an item in the menu.
           g : "Gripe" via email to administrator of current
          item.
           n : Find next search item.
           $, !   : Spawn to subprocess (use "logout" to return
          to session)
           Ctrl-T : Show host's local date and time.


GGOOPPHHEERR OOBBJJEECCTTSS
     Menu entries ending with "/" are directories; additional
     characteristics for files (such as binary, sound, image, and
     others) are identified within angle brackets.


           Item tag    Type      Description
           --------------------------------------------
           (none)        0       file
           /             1       directory
           <)            s       sound file
           <Picture>    I,g      image file
           <Movie>       ;       movie file
           <HQX>         4       BinHexed Macintosh file
           <Bin>         9       binary file
           <PC Bin>      5       DOS binary file


Printed 7/22/94                                                 3


GOPHER(1)              ConvexOS Man Pages              GOPHER(1)


           <CSO>         2       CSO (ph/qi) phone-book server
           <TEL>         8       telnet connection
           <3270>        T       telnet connection (IBM 3270 emu-
          lation)
           <MIME>        M       Multi-purpose Internet Mail
          Extensions file
           <HTML>        h       HyperText Markup Language file
           <?>           7       index-search item
           <??>        (none)    ASK form


EEXXAAMMPPLLEESS
     gopher gopher.tc.umn.edu
          Connect to the gopher server running on the computer
          _g_o_p_h_e_r._t_c._u_m_n._e_d_u


     gopher -p "1/Information About Gopher" gopher.tc.umn.edu 70
          Connect to the gopher server running on port 70 of the
          computer _g_o_p_h_e_r._t_c._u_m_n._e_d_u and start at the menu
          retrieved with the selector string _1/_I_n_f_o_r_m_a_t_i_o_n _A_b_o_u_t
          _G_o_p_h_e_r


mudhoney.micro.umn.edu
     gopher -p 7/indexes/Gopher-index/index -T 7 -i FAQ
          Connect to the gopher server running on the computer
          _m_u_d_h_o_n_e_y._m_i_c_r_o._u_m_n._e_d_u and start at the menu of items
          matching the string _F_A_Q in the index specified by the
          selector string _7/_i_n_d_e_x_e_s/_G_o_p_h_e_r-_i_n_d_e_x/_i_n_d_e_x


CCOONNFFIIGGUURRAATTIIOONN FFIILLEE FFOORRMMAATT
     The client gets configuration data from the system gopher.rc
     file and the user's .gopherrc files.  The options in these
     files may be set by using the OO key in the client.


     See the manual page for gopherrc for more information about
     these options.


EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
     The client also checks for environment variables for its
     configuration information.  The following variables can be
     used:

     GOPHER_TELNET:
          The program used to connect to telnet services

     GOPHER_TN3270:
          The program used to connect to TN3270 services


Printed 7/22/94                                                 4


GOPHER(1)              ConvexOS Man Pages              GOPHER(1)


     GOPHER_HTML:
          The program used to read HyperText Markup Language
          documents.

     GOPHER_PRINTER:
          The program used to print from a pipe.


FFIILLEESS
     $HOME/.gopherrc
          user bookmarks and configuration information

     /usr/local/lib/gopher.rc
          system default configuration information (default loca-
          tion - may be somewhere else on your system)

     /usr/local/lib/gopher.hlp
          client help file displayed by the '?' command (default
          location - may be somewhere else on your system)


CCOOPPYYRRIIGGHHTT
     The Internet Gopher(tm) software and documentation is copy-
     right (c) 1991, 1992, 1993, 1994 by the University of Min-
     nesota.  Gopher has limitations on its use and comes without
     a warranty.  Please refer to the file 'Copyright' included
     in the distribution.


Printed 7/22/94                                                 5