lib/file-type.c

   1 /* Return a string describing the type of a file.
   2
   3    Copyright (C) 1993-1994, 2001-2002, 2004-2006, 2009-2020 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 }