home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / texinfo-3.7-src.tgz / tar.out / fsf / texinfo / info / filesys.c < prev    next >
C/C++ Source or Header  |  1996-09-28  |  15KB  |  618 lines
  1. /* filesys.c -- File system specific functions for hacking this system. */
  2.  
  3. /* This file is part of GNU Info, a program for reading online documentation
  4.    stored in Info format.
  5.  
  6.    Copyright (C) 1993 Free Software Foundation, Inc.
  7.  
  8.    This program is free software; you can redistribute it and/or modify
  9.    it under the terms of the GNU General Public License as published by
  10.    the Free Software Foundation; either version 2, or (at your option)
  11.    any later version.
  12.  
  13.    This program is distributed in the hope that it will be useful,
  14.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16.    GNU General Public License for more details.
  17.  
  18.    You should have received a copy of the GNU General Public License
  19.    along with this program; if not, write to the Free Software
  20.    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  21.  
  22.    Written by Brian Fox (bfox@ai.mit.edu). */
  23.  
  24. #include <stdio.h>
  25. #include <sys/types.h>
  26. #include <sys/stat.h>
  27. #if defined (HAVE_SYS_FILE_H)
  28. #include <sys/file.h>
  29. #endif /* HAVE_SYS_FILE_H */
  30. #include <sys/errno.h>
  31. #include "general.h"
  32. #include "tilde.h"
  33. #include "filesys.h"
  34.  
  35. #if !defined (O_RDONLY)
  36. #if defined (HAVE_SYS_FCNTL_H)
  37. #include <sys/fcntl.h>
  38. #else /* !HAVE_SYS_FCNTL_H */
  39. #include <fcntl.h>
  40. #endif /* !HAVE_SYS_FCNTL_H */
  41. #endif /* !O_RDONLY */
  42.  
  43. #if !defined (errno)
  44. extern int errno;
  45. #endif /* !errno */
  46.  
  47. /* Found in info-utils.c. */
  48. extern char *filename_non_directory ();
  49.  
  50. #if !defined (BUILDING_LIBRARY)
  51. /* Found in session.c */
  52. extern int info_windows_initialized_p;
  53.  
  54. /* Found in window.c. */
  55. extern void message_in_echo_area (), unmessage_in_echo_area ();
  56. #endif /* !BUILDING_LIBRARY */
  57.  
  58. /* Local to this file. */
  59. static char *info_file_in_path (), *lookup_info_filename ();
  60. static void remember_info_filename (), maybe_initialize_infopath ();
  61.  
  62. #if !defined (NULL)
  63. #  define NULL 0x0
  64. #endif /* !NULL */
  65.  
  66. typedef struct {
  67.   char *suffix;
  68.   char *decompressor;
  69. } COMPRESSION_ALIST;
  70.  
  71. static char *info_suffixes[] = {
  72.   "",
  73.   ".info",
  74.   "-info",
  75.   (char *)NULL
  76. };
  77.  
  78. static COMPRESSION_ALIST compress_suffixes[] = {
  79.   { ".Z", "uncompress" },
  80.   { ".Y", "unyabba" },
  81.   { ".z", "gunzip" },
  82.   { ".gz", "gunzip" },
  83.   { (char *)NULL, (char *)NULL }
  84. };
  85.  
  86. /* The path on which we look for info files.  You can initialize this
  87.    from the environment variable INFOPATH if there is one, or you can
  88.    call info_add_path () to add paths to the beginning or end of it.
  89.    You can call zap_infopath () to make the path go away. */
  90. char *infopath = (char *)NULL;
  91. static int infopath_size = 0;
  92.  
  93. /* Expand the filename in PARTIAL to make a real name for this operating
  94.    system.  This looks in INFO_PATHS in order to find the correct file.
  95.    If it can't find the file, it returns NULL. */
  96. static char *local_temp_filename = (char *)NULL;
  97. static int local_temp_filename_size = 0;
  98.  
  99. char *
  100. info_find_fullpath (partial)
  101.      char *partial;
  102. {
  103.   int initial_character;
  104.   char *temp;
  105.  
  106.   filesys_error_number = 0;
  107.  
  108.   maybe_initialize_infopath ();
  109.  
  110.   if (partial && (initial_character = *partial))
  111.     {
  112.       char *expansion;
  113.  
  114.       expansion = lookup_info_filename (partial);
  115.  
  116.       if (expansion)
  117.     return (expansion);
  118.  
  119.       /* If we have the full path to this file, we still may have to add
  120.      various extensions to it.  I guess we have to stat this file
  121.      after all. */
  122.       if (initial_character == '/')
  123.     temp = info_file_in_path (partial + 1, "/");
  124.       else if (initial_character == '~')
  125.     {
  126.       expansion = tilde_expand_word (partial);
  127.       if (*expansion == '/')
  128.         {
  129.           temp = info_file_in_path (expansion + 1, "/");
  130.           free (expansion);
  131.         }
  132.       else
  133.         temp = expansion;
  134.     }
  135.       else if (initial_character == '.' &&
  136.            (partial[1] == '/' || (partial[1] == '.' && partial[2] == '/')))
  137.     {
  138.       if (local_temp_filename_size < 1024)
  139.         local_temp_filename = (char *)xrealloc
  140.           (local_temp_filename, (local_temp_filename_size = 1024));
  141. #if defined (HAVE_GETCWD)
  142.       if (!getcwd (local_temp_filename, local_temp_filename_size))
  143. #else /*  !HAVE_GETCWD */
  144.       if (!getwd (local_temp_filename))
  145. #endif /* !HAVE_GETCWD */
  146.         {
  147.           filesys_error_number = errno;
  148.           return (partial);
  149.         }
  150.  
  151.       strcat (local_temp_filename, "/");
  152.       strcat (local_temp_filename, partial);
  153.       return (local_temp_filename);
  154.     }
  155.       else
  156.     temp = info_file_in_path (partial, infopath);
  157.  
  158.       if (temp)
  159.     {
  160.       remember_info_filename (partial, temp);
  161.       if (strlen (temp) > local_temp_filename_size)
  162.         local_temp_filename = (char *) xrealloc
  163.           (local_temp_filename,
  164.            (local_temp_filename_size = (50 + strlen (temp))));
  165.       strcpy (local_temp_filename, temp);
  166.       free (temp);
  167.       return (local_temp_filename);
  168.     }
  169.     }
  170.   return (partial);
  171. }
  172.  
  173. /* Scan the list of directories in PATH looking for FILENAME.  If we find
  174.    one that is a regular file, return it as a new string.  Otherwise, return
  175.    a NULL pointer. */
  176. static char *
  177. info_file_in_path (filename, path)
  178.      char *filename, *path;
  179. {
  180.   struct stat finfo;
  181.   char *temp_dirname;
  182.   int statable, dirname_index;
  183.  
  184.   dirname_index = 0;
  185.  
  186.   while (temp_dirname = extract_colon_unit (path, &dirname_index))
  187.     {
  188.       register int i, pre_suffix_length;
  189.       char *temp;
  190.  
  191.       /* Expand a leading tilde if one is present. */
  192.       if (*temp_dirname == '~')
  193.     {
  194.       char *expanded_dirname;
  195.  
  196.       expanded_dirname = tilde_expand_word (temp_dirname);
  197.       free (temp_dirname);
  198.       temp_dirname = expanded_dirname;
  199.     }
  200.  
  201.       temp = (char *)xmalloc (30 + strlen (temp_dirname) + strlen (filename));
  202.       strcpy (temp, temp_dirname);
  203.       if (temp[(strlen (temp)) - 1] != '/')
  204.     strcat (temp, "/");
  205.       strcat (temp, filename);
  206.  
  207.       pre_suffix_length = strlen (temp);
  208.  
  209.       free (temp_dirname);
  210.  
  211.       for (i = 0; info_suffixes[i]; i++)
  212.     {
  213.       strcpy (temp + pre_suffix_length, info_suffixes[i]);
  214.  
  215.       statable = (stat (temp, &finfo) == 0);
  216.  
  217.       /* If we have found a regular file, then use that.  Else, if we
  218.          have found a directory, look in that directory for this file. */
  219.       if (statable)
  220.         {
  221.           if (S_ISREG (finfo.st_mode))
  222.         {
  223.           return (temp);
  224.         }
  225.           else if (S_ISDIR (finfo.st_mode))
  226.         {
  227.           char *newpath, *filename_only, *newtemp;
  228.  
  229.           newpath = strdup (temp);
  230.           filename_only = filename_non_directory (filename);
  231.           newtemp = info_file_in_path (filename_only, newpath);
  232.  
  233.           free (newpath);
  234.           if (newtemp)
  235.             {
  236.               free (temp);
  237.               return (newtemp);
  238.             }
  239.         }
  240.         }
  241.       else
  242.         {
  243.           /* Add various compression suffixes to the name to see if
  244.          the file is present in compressed format. */
  245.           register int j, pre_compress_suffix_length;
  246.  
  247.           pre_compress_suffix_length = strlen (temp);
  248.  
  249.           for (j = 0; compress_suffixes[j].suffix; j++)
  250.         {
  251.           strcpy (temp + pre_compress_suffix_length,
  252.               compress_suffixes[j].suffix);
  253.  
  254.           statable = (stat (temp, &finfo) == 0);
  255.           if (statable && (S_ISREG (finfo.st_mode)))
  256.             return (temp);
  257.         }
  258.         }
  259.     }
  260.       free (temp);
  261.     }
  262.   return ((char *)NULL);
  263. }
  264.  
  265. /* Given a string containing units of information separated by colons,
  266.    return the next one pointed to by IDX, or NULL if there are no more.
  267.    Advance IDX to the character after the colon. */
  268. char *
  269. extract_colon_unit (string, idx)
  270.      char *string;
  271.      int *idx;
  272. {
  273.   register int i, start;
  274.  
  275.   i = start = *idx;
  276.   if ((i >= strlen (string)) || !string)
  277.     return ((char *) NULL);
  278.  
  279.   while (string[i] && string[i] != ':')
  280.     i++;
  281.   if (i == start)
  282.     {
  283.       return ((char *) NULL);
  284.     }
  285.   else
  286.     {
  287.       char *value;
  288.  
  289.       value = (char *) xmalloc (1 + (i - start));
  290.       strncpy (value, &string[start], (i - start));
  291.       value[i - start] = '\0';
  292.       if (string[i])
  293.     ++i;
  294.       *idx = i;
  295.       return (value);
  296.     }
  297. }
  298.  
  299. /* A structure which associates a filename with its expansion. */
  300. typedef struct {
  301.   char *filename;
  302.   char *expansion;
  303. } FILENAME_LIST;
  304.  
  305. /* An array of remembered arguments and results. */
  306. static FILENAME_LIST **names_and_files = (FILENAME_LIST **)NULL;
  307. static int names_and_files_index = 0;
  308. static int names_and_files_slots = 0;
  309.  
  310. /* Find the result for having already called info_find_fullpath () with
  311.    FILENAME. */
  312. static char *
  313. lookup_info_filename (filename)
  314.      char *filename;
  315. {
  316.   if (filename && names_and_files)
  317.     {
  318.       register int i;
  319.       for (i = 0; names_and_files[i]; i++)
  320.     {
  321.       if (strcmp (names_and_files[i]->filename, filename) == 0)
  322.         return (names_and_files[i]->expansion);
  323.     }
  324.     }
  325.   return (char *)NULL;;
  326. }
  327.  
  328. /* Add a filename and its expansion to our list. */
  329. static void
  330. remember_info_filename (filename, expansion)
  331.      char *filename, *expansion;
  332. {
  333.   FILENAME_LIST *new;
  334.  
  335.   if (names_and_files_index + 2 > names_and_files_slots)
  336.     {
  337.       int alloc_size;
  338.       names_and_files_slots += 10;
  339.  
  340.       alloc_size = names_and_files_slots * sizeof (FILENAME_LIST *);
  341.  
  342.       names_and_files =
  343.     (FILENAME_LIST **) xrealloc (names_and_files, alloc_size);
  344.     }
  345.  
  346.   new = (FILENAME_LIST *)xmalloc (sizeof (FILENAME_LIST));
  347.   new->filename = strdup (filename);
  348.   new->expansion = expansion ? strdup (expansion) : (char *)NULL;
  349.  
  350.   names_and_files[names_and_files_index++] = new;
  351.   names_and_files[names_and_files_index] = (FILENAME_LIST *)NULL;
  352. }
  353.  
  354. static void
  355. maybe_initialize_infopath ()
  356. {
  357.   if (!infopath_size)
  358.     {
  359.       infopath = (char *)
  360.     xmalloc (infopath_size = (1 + strlen (DEFAULT_INFOPATH)));
  361.  
  362.       strcpy (infopath, DEFAULT_INFOPATH);
  363.     }
  364. }
  365.  
  366. /* Add PATH to the list of paths found in INFOPATH.  2nd argument says
  367.    whether to put PATH at the front or end of INFOPATH. */
  368. void
  369. info_add_path (path, where)
  370.      char *path;
  371.      int where;
  372. {
  373.   int len;
  374.  
  375.   if (!infopath)
  376.     {
  377.       infopath = (char *)xmalloc (infopath_size = 200 + strlen (path));
  378.       infopath[0] = '\0';
  379.     }
  380.  
  381.   len = strlen (path) + strlen (infopath);
  382.  
  383.   if (len + 2 >= infopath_size)
  384.     infopath = (char *)xrealloc (infopath, (infopath_size += (2 * len) + 2));
  385.  
  386.   if (!*infopath)
  387.     strcpy (infopath, path);
  388.   else if (where == INFOPATH_APPEND)
  389.     {
  390.       strcat (infopath, ":");
  391.       strcat (infopath, path);
  392.     }
  393.   else if (where == INFOPATH_PREPEND)
  394.     {
  395.       char *temp = strdup (infopath);
  396.       strcpy (infopath, path);
  397.       strcat (infopath, ":");
  398.       strcat (infopath, temp);
  399.       free (temp);
  400.     }
  401. }
  402.  
  403. /* Make INFOPATH have absolutely nothing in it. */
  404. void
  405. zap_infopath ()
  406. {
  407.   if (infopath)
  408.     free (infopath);
  409.  
  410.   infopath = (char *)NULL;
  411.   infopath_size = 0;
  412. }
  413.  
  414. /* Read the contents of PATHNAME, returning a buffer with the contents of
  415.    that file in it, and returning the size of that buffer in FILESIZE.
  416.    FINFO is a stat struct which has already been filled in by the caller.
  417.    If the file cannot be read, return a NULL pointer. */
  418. char *
  419. filesys_read_info_file (pathname, filesize, finfo)
  420.      char *pathname;
  421.      long *filesize;
  422.      struct stat *finfo;
  423. {
  424.   long st_size;
  425.  
  426.   *filesize = filesys_error_number = 0;
  427.  
  428.   if (compressed_filename_p (pathname))
  429.     return (filesys_read_compressed (pathname, filesize, finfo));
  430.   else
  431.     {
  432.       int descriptor;
  433.       char *contents;
  434.  
  435.       descriptor = open (pathname, O_RDONLY, 0666);
  436.  
  437.       /* If the file couldn't be opened, give up. */
  438.       if (descriptor < 0)
  439.     {
  440.       filesys_error_number = errno;
  441.       return ((char *)NULL);
  442.     }
  443.  
  444.       /* Try to read the contents of this file. */
  445.       st_size = (long) finfo->st_size;
  446.       contents = (char *)xmalloc (1 + st_size);
  447.       if ((read (descriptor, contents, st_size)) != st_size)
  448.     {
  449.       filesys_error_number = errno;
  450.       close (descriptor);
  451.       free (contents);
  452.       return ((char *)NULL);
  453.     }
  454.  
  455.       close (descriptor);
  456.  
  457.       *filesize = st_size;
  458.       return (contents);
  459.     }
  460. }
  461.  
  462. /* Typically, pipe buffers are 4k. */
  463. #define BASIC_PIPE_BUFFER (4 * 1024)
  464.  
  465. /* We use some large multiple of that. */
  466. #define FILESYS_PIPE_BUFFER_SIZE (16 * BASIC_PIPE_BUFFER)
  467.  
  468. char *
  469. filesys_read_compressed (pathname, filesize, finfo)
  470.      char *pathname;
  471.      long *filesize;
  472.      struct stat *finfo;
  473. {
  474.   FILE *stream;
  475.   char *command, *decompressor;
  476.   char *contents = (char *)NULL;
  477.  
  478.   *filesize = filesys_error_number = 0;
  479.  
  480.   decompressor = filesys_decompressor_for_file (pathname);
  481.  
  482.   if (!decompressor)
  483.     return ((char *)NULL);
  484.  
  485.   command = (char *)xmalloc (10 + strlen (pathname) + strlen (decompressor));
  486.   sprintf (command, "%s < %s", decompressor, pathname);
  487.  
  488. #if !defined (BUILDING_LIBRARY)
  489.   if (info_windows_initialized_p)
  490.     {
  491.       char *temp;
  492.  
  493.       temp = (char *)xmalloc (5 + strlen (command));
  494.       sprintf (temp, "%s...", command);
  495.       message_in_echo_area ("%s", temp);
  496.       free (temp);
  497.     }
  498. #endif /* !BUILDING_LIBRARY */
  499.  
  500.   stream = popen (command, "r");
  501.   free (command);
  502.  
  503.   /* Read chunks from this file until there are none left to read. */
  504.   if (stream)
  505.     {
  506.       int offset, size;
  507.       char *chunk;
  508.     
  509.       offset = size = 0;
  510.       chunk = (char *)xmalloc (FILESYS_PIPE_BUFFER_SIZE);
  511.  
  512.       while (1)
  513.     {
  514.       int bytes_read;
  515.  
  516.       bytes_read = fread (chunk, 1, FILESYS_PIPE_BUFFER_SIZE, stream);
  517.  
  518.       if (bytes_read + offset >= size)
  519.         contents = (char *)xrealloc
  520.           (contents, size += (2 * FILESYS_PIPE_BUFFER_SIZE));
  521.  
  522.       memcpy (contents + offset, chunk, bytes_read);
  523.       offset += bytes_read;
  524.       if (bytes_read != FILESYS_PIPE_BUFFER_SIZE)
  525.         break;
  526.     }
  527.  
  528.       free (chunk);
  529.       pclose (stream);
  530.       contents = (char *)xrealloc (contents, offset + 1);
  531.       *filesize = offset;
  532.     }
  533.   else
  534.     {
  535.       filesys_error_number = errno;
  536.     }
  537.  
  538. #if !defined (BUILDING_LIBARARY)
  539.   if (info_windows_initialized_p)
  540.     unmessage_in_echo_area ();
  541. #endif /* !BUILDING_LIBRARY */
  542.   return (contents);
  543. }
  544.  
  545. /* Return non-zero if FILENAME belongs to a compressed file. */
  546. int
  547. compressed_filename_p (filename)
  548.      char *filename;
  549. {
  550.   char *decompressor;
  551.  
  552.   /* Find the final extension of this filename, and see if it matches one
  553.      of our known ones. */
  554.   decompressor = filesys_decompressor_for_file (filename);
  555.  
  556.   if (decompressor)
  557.     return (1);
  558.   else
  559.     return (0);
  560. }
  561.  
  562. /* Return the command string that would be used to decompress FILENAME. */
  563. char *
  564. filesys_decompressor_for_file (filename)
  565.      char *filename;
  566. {
  567.   register int i;
  568.   char *extension = (char *)NULL;
  569.  
  570.   /* Find the final extension of FILENAME, and see if it appears in our
  571.      list of known compression extensions. */
  572.   for (i = strlen (filename) - 1; i > 0; i--)
  573.     if (filename[i] == '.')
  574.       {
  575.     extension = filename + i;
  576.     break;
  577.       }
  578.  
  579.   if (!extension)
  580.     return ((char *)NULL);
  581.  
  582.   for (i = 0; compress_suffixes[i].suffix; i++)
  583.     if (strcmp (extension, compress_suffixes[i].suffix) == 0)
  584.       return (compress_suffixes[i].decompressor);
  585.  
  586.   return ((char *)NULL);
  587. }
  588.  
  589. /* The number of the most recent file system error. */
  590. int filesys_error_number = 0;
  591.  
  592. /* A function which returns a pointer to a static buffer containing
  593.    an error message for FILENAME and ERROR_NUM. */
  594. static char *errmsg_buf = (char *)NULL;
  595. static int errmsg_buf_size = 0;
  596.  
  597. char *
  598. filesys_error_string (filename, error_num)
  599.      char *filename;
  600.      int error_num;
  601. {
  602.   int len;
  603.   char *result;
  604.  
  605.   if (error_num == 0)
  606.     return ((char *)NULL);
  607.  
  608.   result = strerror (error_num);
  609.  
  610.   len = 4 + strlen (filename) + strlen (result);
  611.   if (len >= errmsg_buf_size)
  612.     errmsg_buf = (char *)xrealloc (errmsg_buf, (errmsg_buf_size = 2 + len));
  613.  
  614.   sprintf (errmsg_buf, "%s: %s", filename, result);
  615.   return (errmsg_buf);
  616. }
  617.  
  618.