root/maint/gnulib/lib/file-type.c

/* */

DEFINITIONS

1. file_type

   1 /* Return a string describing the type of a file.
   2 
   3    Copyright (C) 1993-1994, 2001-2002, 2004-2006, 2009-2021 Free Software
   4    Foundation, Inc.
   5 
   6    This program is free software: you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10 
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15 
  16    You should have received a copy of the GNU General Public License
  17    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  18 
  19 /* Written by Paul Eggert.  */
  20 
  21 #include <config.h>
  22 
  23 #include "file-type.h"
  24 
  25 #include <gettext.h>
  26 #define _(text) gettext (text)
  27 
  28 char const *
  29 file_type (struct stat const *st)
     /*  */
  30 {
  31   /* See POSIX 1003.1-2001 XCU Table 4-8 lines 17093-17107 for some of
  32      these formats.
  33 
  34      To keep diagnostics grammatical in English, the returned string
  35      must start with a consonant.  */
  36 
  37   /* Do these three first, as they're the most common.  */
  38 
  39   if (S_ISREG (st->st_mode))
  40     return st->st_size == 0 ? _("regular empty file") : _("regular file");
  41 
  42   if (S_ISDIR (st->st_mode))
  43     return _("directory");
  44 
  45   if (S_ISLNK (st->st_mode))
  46     return _("symbolic link");
  47 
  48   /* Do the S_TYPEIS* macros next, as they may be implemented in terms
  49      of S_ISNAM, and we want the more-specialized interpretation.  */
  50 
  51   if (S_TYPEISMQ (st))
  52     return _("message queue");
  53 
  54   if (S_TYPEISSEM (st))
  55     return _("semaphore");
  56 
  57   if (S_TYPEISSHM (st))
  58     return _("shared memory object");
  59 
  60   if (S_TYPEISTMO (st))
  61     return _("typed memory object");
  62 
  63   /* The remaining are in alphabetical order.  */
  64 
  65   if (S_ISBLK (st->st_mode))
  66     return _("block special file");
  67 
  68   if (S_ISCHR (st->st_mode))
  69     return _("character special file");
  70 
  71   if (S_ISCTG (st->st_mode))
  72     return _("contiguous data");
  73 
  74   if (S_ISFIFO (st->st_mode))
  75     return _("fifo");
  76 
  77   if (S_ISDOOR (st->st_mode))
  78     return _("door");
  79 
  80   if (S_ISMPB (st->st_mode))
  81     return _("multiplexed block special file");
  82 
  83   if (S_ISMPC (st->st_mode))
  84     return _("multiplexed character special file");
  85 
  86   if (S_ISMPX (st->st_mode))
  87     return _("multiplexed file");
  88 
  89   if (S_ISNAM (st->st_mode))
  90     return _("named file");
  91 
  92   if (S_ISNWK (st->st_mode))
  93     return _("network special file");
  94 
  95   if (S_ISOFD (st->st_mode))
  96     return _("migrated file with data");
  97 
  98   if (S_ISOFL (st->st_mode))
  99     return _("migrated file without data");
 100 
 101   if (S_ISPORT (st->st_mode))
 102     return _("port");
 103 
 104   if (S_ISSOCK (st->st_mode))
 105     return _("socket");
 106 
 107   if (S_ISWHT (st->st_mode))
 108     return _("whiteout");
 109 
 110   return _("weird file");
 111 }

/* */