Trouble Shooting

   If things are not working as they should here are some tips to help
   you isolate the problems.
   
   First if the compilation of _gn_ failed and produced an error message
   like

     ld: Undefined symbol
     _putenv

   it means that the C programming libraries on your system do not
   contain the function _putenv()_. For four functions, which seem to be
   less commonly than they should be, versions have been supplied. They
   are putenv(), strncasecmp(), strstr() and strftime(). To use them you
   will need to edit config.h and uncomment the line #define NEED_PUTENV,
   for example. If the compilation was successful you can check the
   server itself by executing it from the command line. If you use the
   command "gn /full/path/of/root/dir", it should run and pause for
   input. Type a return in response and gn should print the "gopher
   protocol lines" of your top level .cache file and exit. If instead of
   a return you type the "selector" for a file (i.e. the contents of the
   Path= line in the menu, like "0/dir/filename") then gn should display
   the contents of that file and exit.
   
   If this doesn't happen there should be an error message which may be
   helpful. Better error messages are placed in the log file so you may
   want run gn again with the additional arguments "-L logfile" and then
   examine the contents of the logfile. Or if you run "gn -L /dev/tty"
   the log entries will be printed to your screen instead of being put in
   a file. If it can't open a file, for example, the name of that file
   will be recorded in the logfile. Check its permissions. Remember that
   all files that gn servers must be world readable.
   
   A second useful test is to telnet to your server at port 70. You
   should get a connection message and a pause for input. If you get a
   "Connection refused" message it is likely there is a problem with your
   inetd setup or for some reason your system can't find or can't execute
   the gn binary.
   
   _Why won't my image.gif display?_ The most common reason is that you
   have forgotten that image.gif must be in a menu file and the .cache
   file produced from it. Just putting a line like

    <img src="images/picture.gif">

   
   
   is not sufficient. For security reasons the server won't serve
   anything not in a .cache file. You must have your images in menu
   files. Of course, if you don't want them to show on clients menus you
   should use an "Attribute=invisible" line with them in the menu.
   
.