src/filename.c

   1 /* PSPP - computes sample statistics.
   2    Copyright (C) 1997-9, 2000 Free Software Foundation, Inc.
   3    Written by Ben Pfaff <blp@gnu.org>.
   4
   5    This program is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU General Public License as
   7    published by the Free Software Foundation; either version 2 of the
   8    License, or (at your option) any later version.
   9
  10    This program is distributed in the hope that it will be useful, but
  11    WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    General Public License for more details.
  14
  15    You should have received a copy of the GNU General Public License
  16    along with this program; if not, write to the Free Software
  17    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  18    02110-1301, USA. */
  19
  20 #include <config.h>
  21 #include "error.h"
  22 #include "filename.h"
  23 #include <stdio.h>
  24 #include <stdlib.h>
  25 #include <ctype.h>
  26 #include <errno.h>
  27 #include "alloc.h"
  28 #include "error.h"
  29 #include "settings.h"
  30 #include "str.h"
  31 #include "version.h"
  32 #include "xreadlink.h"
  33
  34 #include "gettext.h"
  35 #define _(msgid) gettext (msgid)
  36
  37 #include "debug-print.h"
  38
  39 /* PORTME: Everything in this file is system dependent. */
  40
  41 #ifdef unix
  42 #include <pwd.h>
  43 #if HAVE_UNISTD_H
  44 #include <unistd.h>
  45 #endif
  46 #include <sys/stat.h>
  47 #include "stat-macros.h"
  48 #endif
  49
  50 #ifdef __WIN32__
  51 #define NOGDI
  52 #define NOUSER
  53 #define NONLS
  54 #include <win32/windows.h>
  55 #endif
  56
  57 #if __DJGPP__
  58 #include <sys/stat.h>
  59 #endif
  60 \f
  61 /* Initialization. */
  62
  63 const char *config_path;
  64
  65 void
  66 fn_init (void)
  67 {
  68   config_path = fn_getenv_default ("STAT_CONFIG_PATH", default_config_path);
  69 }
  70 \f
  71 /* Functions for performing operations on filenames. */
  72
  73 /* Substitutes $variables as defined by GETENV into INPUT and returns
  74    a copy of the resultant string.  Supports $var and ${var} syntaxes;
  75    $$ substitutes as $. */
  76 char *
  77 fn_interp_vars (const char *input, const char *(*getenv) (const char *))
  78 {
  79   struct string output;
  80
  81   if (NULL == strchr (input, '$'))
  82     return xstrdup (input);
  83
  84   ds_init (&output, strlen (input));
  85
  86   for (;;)
  87     switch (*input)
  88       {
  89       case '\0':
  90         return ds_c_str (&output);
  91
  92       case '$':
  93         input++;
  94
  95         if (*input == '$')
  96           {
  97             ds_putc (&output, '$');
  98             input++;
  99           }
 100         else
 101           {
 102             int stop;
 103             int start;
 104             const char *value;
 105
 106             start = ds_length (&output);
 107
 108             if (*input == '(')
 109               {
 110                 stop = ')';
 111                 input++;
 112               }
 113             else if (*input == '{')
 114               {
 115                 stop = '}';
 116                 input++;
 117               }
 118             else
 119               stop = 0;
 120
 121             while (*input && *input != stop
 122                    && (stop || isalpha ((unsigned char) *input)))
 123               ds_putc (&output, *input++);
 124
 125             value = getenv (ds_c_str (&output) + start);
 126             ds_truncate (&output, start);
 127             ds_puts (&output, value);
 128
 129             if (stop && *input == stop)
 130               input++;
 131           }
 132
 133       default:
 134         ds_putc (&output, *input++);
 135       }
 136 }
 137
 138 #ifdef unix
 139 /* Expands csh tilde notation from the path INPUT into a malloc()'d
 140    returned string. */
 141 char *
 142 fn_tilde_expand (const char *input)
 143 {
 144   const char *ip;
 145   struct string output;
 146
 147   if (NULL == strchr (input, '~'))
 148     return xstrdup (input);
 149   ds_init (&output, strlen (input));
 150
 151   ip = input;
 152
 153   for (ip = input; *ip; )
 154     if (*ip != '~' || (ip != input && ip[-1] != PATH_DELIMITER))
 155       ds_putc (&output, *ip++);
 156     else
 157       {
 158         static const char stop_set[3] = {DIR_SEPARATOR, PATH_DELIMITER, 0};
 159         const char *cp;
 160
 161         ip++;
 162
 163         cp = ip + strcspn (ip, stop_set);
 164
 165         if (cp > ip)
 166           {
 167             struct passwd *pwd;
 168             char username[9];
 169
 170             strncpy (username, ip, cp - ip + 1);
 171             username[8] = 0;
 172             pwd = getpwnam (username);
 173
 174             if (!pwd || !pwd->pw_dir)
 175               ds_putc (&output, *ip++);
 176             else
 177               ds_puts (&output, pwd->pw_dir);
 178           }
 179         else
 180           {
 181             const char *home = fn_getenv ("HOME");
 182             if (!home)
 183               ds_putc (&output, *ip++);
 184             else
 185               ds_puts (&output, home);
 186           }
 187
 188         ip = cp;
 189       }
 190
 191   return ds_c_str (&output);
 192 }
 193 #else /* !unix */
 194 char *
 195 fn_tilde_expand (const char *input)
 196 {
 197   return xstrdup (input);
 198 }
 199 #endif /* !unix */
 200
 201 /* Searches for a configuration file with name NAME in the path given
 202    by PATH, which is tilde- and environment-interpolated.  Directories
 203    in PATH are delimited by PATH_DELIMITER, defined in <pref.h>.
 204    Returns the malloc'd full name of the first file found, or NULL if
 205    none is found.
 206
 207    If PREPEND is non-NULL, then it is prepended to each filename;
 208    i.e., it looks like PREPEND/PATH_COMPONENT/NAME.  This is not done
 209    with absolute directories in the path. */
 210 #if defined (unix) || defined (__MSDOS__) || defined (__WIN32__)
 211 char *
 212 fn_search_path (const char *basename, const char *path, const char *prepend)
 213 {
 214   char *subst_path;
 215   struct string filename;
 216   const char *bp;
 217
 218   if (fn_absolute_p (basename))
 219     return fn_tilde_expand (basename);
 220
 221   {
 222     char *temp = fn_interp_vars (path, fn_getenv);
 223     bp = subst_path = fn_tilde_expand (temp);
 224     free (temp);
 225   }
 226
 227   msg (VM (4), _("Searching for `%s'..."), basename);
 228   ds_init (&filename, 64);
 229
 230   for (;;)
 231     {
 232       const char *ep;
 233       if (0 == *bp)
 234         {
 235           msg (VM (4), _("Search unsuccessful!"));
 236           ds_destroy (&filename);
 237           free (subst_path);
 238           return NULL;
 239         }
 240
 241       for (ep = bp; *ep && *ep != PATH_DELIMITER; ep++)
 242         ;
 243
 244       /* Paste together PREPEND/PATH/BASENAME. */
 245       ds_clear (&filename);
 246       if (prepend && !fn_absolute_p (bp))
 247         {
 248           ds_puts (&filename, prepend);
 249           ds_putc (&filename, DIR_SEPARATOR);
 250         }
 251       ds_concat (&filename, bp, ep - bp);
 252       if (ep - bp
 253           && ds_c_str (&filename)[ds_length (&filename) - 1] != DIR_SEPARATOR)
 254         ds_putc (&filename, DIR_SEPARATOR);
 255       ds_puts (&filename, basename);
 256
 257       msg (VM (5), " - %s", ds_c_str (&filename));
 258       if (fn_exists_p (ds_c_str (&filename)))
 259         {
 260           msg (VM (4), _("Found `%s'."), ds_c_str (&filename));
 261           free (subst_path);
 262           return ds_c_str (&filename);
 263         }
 264
 265       if (0 == *ep)
 266         {
 267           msg (VM (4), _("Search unsuccessful!"));
 268           free (subst_path);
 269           ds_destroy (&filename);
 270           return NULL;
 271         }
 272       bp = ep + 1;
 273     }
 274 }
 275 #else /* not unix, msdog, lose32 */
 276 char *
 277 fn_search_path (const char *basename, const char *path, const char *prepend)
 278 {
 279   size_t size = strlen (path) + 1 + strlen (basename) + 1;
 280   char *string;
 281   char *cp;
 282
 283   if (prepend)
 284     size += strlen (prepend) + 1;
 285   string = xmalloc (size);
 286
 287   cp = string;
 288   if (prepend)
 289     {
 290       cp = stpcpy (cp, prepend);
 291       *cp++ = DIR_SEPARATOR;
 292     }
 293   cp = stpcpy (cp, path);
 294   *cp++ = DIR_SEPARATOR;
 295   strcpy (cp, basename);
 296
 297   return string;
 298 }
 299 #endif /* not unix, msdog, lose32 */
 300
 301 /* Prepends directory DIR to filename FILE and returns a malloc()'d
 302    copy of it. */
 303 char *
 304 fn_prepend_dir (const char *file, const char *dir)
 305 {
 306   char *temp;
 307   char *cp;
 308
 309   if (fn_absolute_p (file))
 310     return xstrdup (file);
 311
 312   temp = xmalloc (strlen (file) + 1 + strlen (dir) + 1);
 313   cp = stpcpy (temp, dir);
 314   if (cp != temp && cp[-1] != DIR_SEPARATOR)
 315     *cp++ = DIR_SEPARATOR;
 316   cp = stpcpy (cp, file);
 317
 318   return temp;
 319 }
 320
 321 /* fn_normalize(): This very OS-dependent routine canonicalizes
 322    filename FN1.  The filename should not need to be the name of an
 323    existing file.  Returns a malloc()'d copy of the canonical name.
 324    This function must always succeed; if it needs to bail out then it
 325    should return xstrdup(FN1).  */
 326 #ifdef unix
 327 char *
 328 fn_normalize (const char *filename)
 329 {
 330   const char *src;
 331   char *fn1, *fn2, *dest;
 332   int maxlen;
 333
 334   if (fn_special_p (filename))
 335     return xstrdup (filename);
 336
 337   fn1 = fn_tilde_expand (filename);
 338
 339   /* Follow symbolic links. */
 340   for (;;)
 341     {
 342       fn2 = fn1;
 343       fn1 = fn_readlink (fn1);
 344       if (!fn1)
 345         {
 346           fn1 = fn2;
 347           break;
 348         }
 349       free (fn2);
 350     }
 351
 352   maxlen = strlen (fn1) * 2;
 353   if (maxlen < 31)
 354     maxlen = 31;
 355   dest = fn2 = xmalloc (maxlen + 1);
 356   src = fn1;
 357
 358   if (*src == DIR_SEPARATOR)
 359     *dest++ = *src++;
 360   else
 361     {
 362       errno = 0;
 363       while (getcwd (dest, maxlen - (dest - fn2)) == NULL && errno == ERANGE)
 364         {
 365           maxlen *= 2;
 366           dest = fn2 = xrealloc (fn2, maxlen + 1);
 367           errno = 0;
 368         }
 369       if (errno)
 370         {
 371           free (fn1);
 372           free (fn2);
 373           return NULL;
 374         }
 375       dest = strchr (fn2, '\0');
 376       if (dest - fn2 >= maxlen)
 377         {
 378           int ofs = dest - fn2;
 379           maxlen *= 2;
 380           fn2 = xrealloc (fn2, maxlen + 1);
 381           dest = fn2 + ofs;
 382         }
 383       if (dest[-1] != DIR_SEPARATOR)
 384         *dest++ = DIR_SEPARATOR;
 385     }
 386
 387   for (;;)
 388     {
 389       int c, f;
 390
 391       c = *src++;
 392
 393       f = 0;
 394       if (c == DIR_SEPARATOR || c == 0)
 395         {
 396           /* remove `./', `../' from directory */
 397           if (dest[-1] == '.' && dest[-2] == DIR_SEPARATOR)
 398             dest--;
 399           else if (dest[-1] == '.' && dest[-2] == '.' && dest[-3] == DIR_SEPARATOR)
 400             {
 401               dest -= 3;
 402               if (dest == fn2)
 403                 dest++;
 404               while (dest[-1] != DIR_SEPARATOR)
 405                 dest--;
 406             }
 407           else if (dest[-1] != DIR_SEPARATOR)   /* remove extra slashes */
 408             f = 1;
 409
 410           if (c == 0)
 411             {
 412               if (dest[-1] == DIR_SEPARATOR && dest > fn2 + 1)
 413                 dest--;
 414               *dest = 0;
 415               free (fn1);
 416
 417               return xrealloc (fn2, strlen (fn2) + 1);
 418             }
 419         }
 420       else
 421         f = 1;
 422
 423       if (f)
 424         {
 425           if (dest - fn2 >= maxlen)
 426             {
 427               int ofs = dest - fn2;
 428               maxlen *= 2;
 429               fn2 = xrealloc (fn2, maxlen + 1);
 430               dest = fn2 + ofs;
 431             }
 432           *dest++ = c;
 433         }
 434     }
 435 }
 436 #elif defined (__WIN32__)
 437 char *
 438 fn_normalize (const char *fn1)
 439 {
 440   DWORD len;
 441   DWORD success;
 442   char *fn2;
 443
 444   /* Don't change special filenames. */
 445   if (is_special_filename (filename))
 446     return xstrdup (filename);
 447
 448   /* First find the required buffer length. */
 449   len = GetFullPathName (fn1, 0, NULL, NULL);
 450   if (!len)
 451     {
 452       fn2 = xstrdup (fn1);
 453       return fn2;
 454     }
 455
 456   /* Then make a buffer that big. */
 457   fn2 = xmalloc (len);
 458   success = GetFullPathName (fn1, len, fn2, NULL);
 459   if (success >= len || success == 0)
 460     {
 461       free (fn2);
 462       fn2 = xstrdup (fn1);
 463       return fn2;
 464     }
 465   return fn2;
 466 }
 467 #elif __BORLANDC__
 468 char *
 469 fn_normalize (const char *fn1)
 470 {
 471   char *fn2 = _fullpath (NULL, fn1, 0);
 472   if (fn2)
 473     {
 474       char *cp;
 475       for (cp = fn2; *cp; cp++)
 476         *cp = toupper ((unsigned char) (*cp));
 477       return fn2;
 478     }
 479   return xstrdup (fn1);
 480 }
 481 #elif __DJGPP__
 482 char *
 483 fn_normalize (const char *fn1)
 484 {
 485   char *fn2 = xmalloc (1024);
 486   _fixpath (fn1, fn2);
 487   fn2 = xrealloc (fn2, strlen (fn2) + 1);
 488   return fn2;
 489 }
 490 #else /* not Lose32, Unix, or DJGPP */
 491 char *
 492 fn_normalize (const char *fn)
 493 {
 494   return xstrdup (fn);
 495 }
 496 #endif /* not Lose32, Unix, or DJGPP */
 497
 498 /* Returns the directory part of FILENAME, as a malloc()'d
 499    string. */
 500 char *
 501 fn_dirname (const char *filename)
 502 {
 503   const char *p;
 504   char *s;
 505   size_t len;
 506
 507   len = strlen (filename);
 508   if (len == 1 && filename[0] == '/')
 509     p = filename + 1;
 510   else if (len && filename[len - 1] == DIR_SEPARATOR)
 511     p = buf_find_reverse (filename, len - 1, filename + len - 1, 1);
 512   else
 513     p = strrchr (filename, DIR_SEPARATOR);
 514   if (p == NULL)
 515     p = filename;
 516
 517   s = xmalloc (p - filename + 1);
 518   memcpy (s, filename, p - filename);
 519   s[p - filename] = 0;
 520
 521   return s;
 522 }
 523
 524 /* Returns the basename part of FILENAME as a malloc()'d string. */
 525 #if 0
 526 char *
 527 fn_basename (const char *filename)
 528 {
 529   /* Not used, not implemented. */
 530   abort ();
 531 }
 532 #endif
 533 \f
 534 #if unix
 535 /* Returns the current working directory, as a malloc()'d string.
 536    From libc.info. */
 537 char *
 538 fn_get_cwd (void)
 539 {
 540   int size = 100;
 541   char *buffer = xmalloc (size);
 542
 543   for (;;)
 544     {
 545       char *value = getcwd (buffer, size);
 546       if (value != 0)
 547         return buffer;
 548
 549       size *= 2;
 550       free (buffer);
 551       buffer = xmalloc (size);
 552     }
 553 }
 554 #else
 555 char *
 556 fn_get_cwd (void)
 557 {
 558   int size = 2;
 559   char *buffer = xmalloc (size);
 560   if ( buffer)
 561   {
 562     buffer[0]='.';
 563     buffer[1]='\0';
 564   }
 565
 566   return buffer;
 567
 568 }
 569 #endif
 570 \f
 571 /* Find out information about files. */
 572
 573 /* Returns nonzero iff NAME specifies an absolute filename. */
 574 int
 575 fn_absolute_p (const char *name)
 576 {
 577 #ifdef unix
 578   if (name[0] == '/'
 579       || !strncmp (name, "./", 2)
 580       || !strncmp (name, "../", 3)
 581       || name[0] == '~')
 582     return 1;
 583 #elif defined (__MSDOS__)
 584   if (name[0] == '\\'
 585       || !strncmp (name, ".\\", 2)
 586       || !strncmp (name, "..\\", 3)
 587       || (name[0] && name[1] == ':'))
 588     return 1;
 589 #endif
 590
 591   return 0;
 592 }
 593
 594 /* Returns 1 if the filename specified is a virtual file that doesn't
 595    really exist on disk, 0 if it's a real filename. */
 596 int
 597 fn_special_p (const char *filename)
 598 {
 599   if (!strcmp (filename, "-") || !strcmp (filename, "stdin")
 600       || !strcmp (filename, "stdout") || !strcmp (filename, "stderr")
 601 #ifdef unix
 602       || filename[0] == '|'
 603       || (*filename && filename[strlen (filename) - 1] == '|')
 604 #endif
 605       )
 606     return 1;
 607
 608   return 0;
 609 }
 610
 611 /* Returns nonzero if file with name NAME exists. */
 612 int
 613 fn_exists_p (const char *name)
 614 {
 615 #ifdef unix
 616   struct stat temp;
 617
 618   return stat (name, &temp) == 0;
 619 #else
 620   FILE *f = fopen (name, "r");
 621   if (!f)
 622     return 0;
 623   fclose (f);
 624   return 1;
 625 #endif
 626 }
 627
 628 /* Returns the symbolic link value for FILENAME as a dynamically
 629    allocated buffer, or a null pointer on failure. */
 630 char *
 631 fn_readlink (const char *filename)
 632 {
 633   return xreadlink (filename, 32);
 634 }
 635 \f
 636 /* Environment variables. */
 637
 638 /* Simulates $VER and $ARCH environment variables. */
 639 const char *
 640 fn_getenv (const char *s)
 641 {
 642   if (!strcmp (s, "VER"))
 643     return fn_getenv_default ("STAT_VER", bare_version);
 644   else if (!strcmp (s, "ARCH"))
 645     return fn_getenv_default ("STAT_ARCH", host_system);
 646   else
 647     return getenv (s);
 648 }
 649
 650 /* Returns getenv(KEY) if that's non-NULL; else returns DEF. */
 651 const char *
 652 fn_getenv_default (const char *key, const char *def)
 653 {
 654   const char *value = getenv (key);
 655   return value ? value : def;
 656 }
 657 \f
 658 /* Basic file handling. */
 659
 660 /* Used for giving an error message on a set_safer security
 661    violation. */
 662 static FILE *
 663 safety_violation (const char *fn)
 664 {
 665   msg (SE, _("Not opening pipe file `%s' because SAFER option set."), fn);
 666   errno = EPERM;
 667   return NULL;
 668 }
 669
 670 /* As a general comment on the following routines, a `sensible value'
 671    for errno includes 0 if there is no associated system error.  The
 672    routines will only set errno to 0 if there is an error in a
 673    callback that sets errno to 0; they themselves won't. */
 674
 675 /* File open routine that understands `-' as stdin/stdout and `|cmd'
 676    as a pipe to command `cmd'.  Returns resultant FILE on success,
 677    NULL on failure.  If NULL is returned then errno is set to a
 678    sensible value.  */
 679 FILE *
 680 fn_open (const char *fn, const char *mode)
 681 {
 682   assert (mode[0] == 'r' || mode[0] == 'w');
 683
 684   if (mode[0] == 'r' && (!strcmp (fn, "stdin") || !strcmp (fn, "-")))
 685     return stdin;
 686   else if (mode[0] == 'w' && (!strcmp (fn, "stdout") || !strcmp (fn, "-")))
 687     return stdout;
 688   else if (mode[0] == 'w' && !strcmp (fn, "stderr"))
 689     return stderr;
 690
 691 #ifdef unix
 692   if (fn[0] == '|')
 693     {
 694       if (safer_mode())
 695         return safety_violation (fn);
 696
 697       return popen (&fn[1], mode);
 698     }
 699   else if (*fn && fn[strlen (fn) - 1] == '|')
 700     {
 701       char *s;
 702       FILE *f;
 703
 704       if (safer_mode())
 705         return safety_violation (fn);
 706
 707       s = local_alloc (strlen (fn));
 708       memcpy (s, fn, strlen (fn) - 1);
 709       s[strlen (fn) - 1] = 0;
 710
 711       f = popen (s, mode);
 712
 713       local_free (s);
 714
 715       return f;
 716     }
 717   else
 718 #endif
 719     {
 720       FILE *f = fopen (fn, mode);
 721
 722       if (f && mode[0] == 'w')
 723         setvbuf (f, NULL, _IOLBF, 0);
 724
 725       return f;
 726     }
 727 }
 728
 729 /* Counterpart to fn_open that closes file F with name FN; returns 0
 730    on success, EOF on failure.  If EOF is returned, errno is set to a
 731    sensible value. */
 732 int
 733 fn_close (const char *fn, FILE *f)
 734 {
 735   if (!strcmp (fn, "-"))
 736     return 0;
 737 #ifdef unix
 738   else if (fn[0] == '|' || (*fn && fn[strlen (fn) - 1] == '|'))
 739     {
 740       pclose (f);
 741       return 0;
 742     }
 743 #endif
 744   else
 745     return fclose (f);
 746 }
 747 \f
 748 /* More extensive file handling. */
 749
 750 /* File open routine that extends fn_open().  Opens or reopens a
 751    file according to the contents of file_ext F.  Returns nonzero on
 752    success.  If 0 is returned, errno is set to a sensible value. */
 753 int
 754 fn_open_ext (struct file_ext *f)
 755 {
 756   char *p;
 757
 758   p = strstr (f->filename, "%d");
 759   if (p)
 760     {
 761       char *s = local_alloc (strlen (f->filename) + INT_DIGITS - 1);
 762       char *cp;
 763
 764       memcpy (s, f->filename, p - f->filename);
 765       cp = spprintf (&s[p - f->filename], "%d", *f->sequence_no);
 766       strcpy (cp, &p[2]);
 767
 768       if (f->file)
 769         {
 770           int error = 0;
 771
 772           if (f->preclose)
 773             if (f->preclose (f) == 0)
 774               error = errno;
 775
 776           if (EOF == fn_close (f->filename, f->file) || error)
 777             {
 778               f->file = NULL;
 779               local_free (s);
 780
 781               if (error)
 782                 errno = error;
 783
 784               return 0;
 785             }
 786
 787           f->file = NULL;
 788         }
 789
 790       f->file = fn_open (s, f->mode);
 791       local_free (s);
 792
 793       if (f->file && f->postopen)
 794         if (f->postopen (f) == 0)
 795           {
 796             int error = errno;
 797             fn_close (f->filename, f->file);
 798             errno = error;
 799
 800             return 0;
 801           }
 802
 803       return (f->file != NULL);
 804     }
 805   else if (f->file)
 806     return 1;
 807   else
 808     {
 809       f->file = fn_open (f->filename, f->mode);
 810
 811       if (f->file && f->postopen)
 812         if (f->postopen (f) == 0)
 813           {
 814             int error = errno;
 815             fn_close (f->filename, f->file);
 816             errno = error;
 817
 818             return 0;
 819           }
 820
 821       return (f->file != NULL);
 822     }
 823 }
 824
 825 /* Properly closes the file associated with file_ext F, if any.
 826    Return nonzero on success.  If zero is returned, errno is set to a
 827    sensible value. */
 828 int
 829 fn_close_ext (struct file_ext *f)
 830 {
 831   if (f->file)
 832     {
 833       int error = 0;
 834
 835       if (f->preclose)
 836         if (f->preclose (f) == 0)
 837           error = errno;
 838
 839       if (EOF == fn_close (f->filename, f->file) || error)
 840         {
 841           f->file = NULL;
 842
 843           if (error)
 844             errno = error;
 845
 846           return 0;
 847         }
 848
 849       f->file = NULL;
 850     }
 851   return 1;
 852 }
 853
 854 #ifdef unix
 855 /* A file's identity. */
 856 struct file_identity
 857   {
 858     dev_t device;               /* Device number. */
 859     ino_t inode;                /* Inode number. */
 860   };
 861
 862 /* Returns a pointer to a dynamically allocated structure whose
 863    value can be used to tell whether two files are actually the
 864    same file.  Returns a null pointer if no information about the
 865    file is available, perhaps because it does not exist.  The
 866    caller is responsible for freeing the structure with
 867    fn_free_identity() when finished. */
 868 struct file_identity *
 869 fn_get_identity (const char *filename)
 870 {
 871   struct stat s;
 872
 873   if (stat (filename, &s) == 0)
 874     {
 875       struct file_identity *identity = xmalloc (sizeof *identity);
 876       identity->device = s.st_dev;
 877       identity->inode = s.st_ino;
 878       return identity;
 879     }
 880   else
 881     return NULL;
 882 }
 883
 884 /* Frees IDENTITY obtained from fn_get_identity(). */
 885 void
 886 fn_free_identity (struct file_identity *identity)
 887 {
 888   free (identity);
 889 }
 890
 891 /* Compares A and B, returning a strcmp()-type result. */
 892 int
 893 fn_compare_file_identities (const struct file_identity *a,
 894                             const struct file_identity *b)
 895 {
 896   assert (a != NULL);
 897   assert (b != NULL);
 898   if (a->device != b->device)
 899     return a->device < b->device ? -1 : 1;
 900   else
 901     return a->inode < b->inode ? -1 : a->inode > b->inode;
 902 }
 903 #else /* not unix */
 904 /* A file's identity. */
 905 struct file_identity
 906   {
 907     char *normalized_filename;  /* File's normalized name. */
 908   };
 909
 910 /* Returns a pointer to a dynamically allocated structure whose
 911    value can be used to tell whether two files are actually the
 912    same file.  Returns a null pointer if no information about the
 913    file is available, perhaps because it does not exist.  The
 914    caller is responsible for freeing the structure with
 915    fn_free_identity() when finished. */
 916 struct file_identity *
 917 fn_get_identity (const char *filename)
 918 {
 919   struct file_identity *identity = xmalloc (sizeof *identity);
 920   identity->normalized_filename = fn_normalize (filename);
 921   return identity;
 922 }
 923
 924 /* Frees IDENTITY obtained from fn_get_identity(). */
 925 void
 926 fn_free_identity (struct file_identity *identity)
 927 {
 928   if (identity != NULL)
 929     {
 930       free (identity->normalized_filename);
 931       free (identity);
 932     }
 933 }
 934
 935 /* Compares A and B, returning a strcmp()-type result. */
 936 int
 937 fn_compare_file_identities (const struct file_identity *a,
 938                             const struct file_identity *b)
 939 {
 940   return strcmp (a->normalized_filename, b->normalized_filename);
 941 }
 942 #endif /* not unix */