mirror of
https://gitlab.freedesktop.org/libbsd/libbsd.git
synced 2025-01-24 02:51:43 +01:00
Add strmode function
This commit is contained in:
Guillem Jover
parent
74ae34e792
commit
8dbfb3529b
6
Makefile
6
Makefile
@ -1,7 +1,7 @@
|
||||
LIB_NAME := libbsd
|
||||
LIB_VERSION_MAJOR := 0
|
||||
LIB_VERSION_MINOR := 0
|
||||
LIB_VERSION_MICRO := 1
|
||||
LIB_VERSION_MINOR := 1
|
||||
LIB_VERSION_MICRO := 0
|
||||
LIB_VERSION := $(LIB_VERSION_MAJOR).$(LIB_VERSION_MINOR).$(LIB_VERSION_MICRO)
|
||||
|
||||
LIB_PKGCONFIG := $(LIB_NAME).pc
|
||||
@ -30,6 +30,7 @@ LIB_SRCS := \
|
||||
inet_net_pton.c \
|
||||
hash/md5.c hash/md5hl.c \
|
||||
setmode.c \
|
||||
strmode.c \
|
||||
strlcat.c strlcpy.c \
|
||||
fmtcheck.c \
|
||||
progname.c \
|
||||
@ -61,6 +62,7 @@ LIB_MANS := \
|
||||
fgetln.3 \
|
||||
fmtcheck.3 \
|
||||
setmode.3 \
|
||||
strmode.3 \
|
||||
md5.3bsd
|
||||
LIB_MANS := $(patsubst %,man/%,$(LIB_MANS))
|
||||
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (C) 2004, 2005 Guillem Jover
|
||||
* Copyright (C) 2004, 2005, 2009 Guillem Jover
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
@ -36,4 +36,6 @@ size_t strlcat(char *dst, const char *src, size_t siz);
|
||||
char *fgetln(FILE *fp, size_t *lenp);
|
||||
wchar_t *fgetwln(FILE * __restrict fp, size_t *lenp);
|
||||
|
||||
void strmode(mode_t mode, char *str);
|
||||
|
||||
#endif
|
||||
|
||||
144
man/strmode.3
Normal file
144
man/strmode.3
Normal file
@ -0,0 +1,144 @@
|
||||
.\" Copyright (c) 1990, 1991, 1993
|
||||
.\" The Regents of the University of California. All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\" 4. Neither the name of the University nor the names of its contributors
|
||||
.\" may be used to endorse or promote products derived from this software
|
||||
.\" without specific prior written permission.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
.\" SUCH DAMAGE.
|
||||
.\"
|
||||
.\" @(#)strmode.3 8.3 (Berkeley) 7/28/94
|
||||
.\" $FreeBSD: src/lib/libc/string/strmode.3,v 1.9 2003/07/01 15:28:05 maxim Exp $
|
||||
.\"
|
||||
.Dd July 28, 1994
|
||||
.Dt STRMODE 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm strmode
|
||||
.Nd convert inode status information into a symbolic string
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.In string.h
|
||||
.Ft void
|
||||
.Fn strmode "mode_t mode" "char *bp"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Fn strmode
|
||||
function
|
||||
converts a file
|
||||
.Fa mode
|
||||
(the type and permission information associated with an inode, see
|
||||
.Xr stat 2 )
|
||||
into a symbolic string which is stored in the location referenced by
|
||||
.Fa bp .
|
||||
This stored string is eleven characters in length plus a trailing
|
||||
.Dv NUL .
|
||||
.Pp
|
||||
The first character is the inode type, and will be one of the following:
|
||||
.Pp
|
||||
.Bl -tag -width flag -offset indent -compact
|
||||
.It \-
|
||||
regular file
|
||||
.It b
|
||||
block special
|
||||
.It c
|
||||
character special
|
||||
.It d
|
||||
directory
|
||||
.It l
|
||||
symbolic link
|
||||
.It p
|
||||
fifo
|
||||
.It s
|
||||
socket
|
||||
.It w
|
||||
whiteout
|
||||
.It ?
|
||||
unknown inode type
|
||||
.El
|
||||
.Pp
|
||||
The next nine characters encode three sets of permissions, in three
|
||||
characters each.
|
||||
The first three characters are the permissions for the owner of the
|
||||
file, the second three for the group the file belongs to, and the
|
||||
third for the ``other'', or default, set of users.
|
||||
.Pp
|
||||
Permission checking is done as specifically as possible.
|
||||
If read permission is denied to the owner of a file in the first set
|
||||
of permissions, the owner of the file will not be able to read the file.
|
||||
This is true even if the owner is in the file's group and the group
|
||||
permissions allow reading or the ``other'' permissions allow reading.
|
||||
.Pp
|
||||
If the first character of the three character set is an ``r'', the file is
|
||||
readable for that set of users; if a dash ``\-'', it is not readable.
|
||||
.Pp
|
||||
If the second character of the three character set is a ``w'', the file is
|
||||
writable for that set of users; if a dash ``\-'', it is not writable.
|
||||
.Pp
|
||||
The third character is the first of the following characters that apply:
|
||||
.Bl -tag -width xxxx
|
||||
.It S
|
||||
If the character is part of the owner permissions and the file is not
|
||||
executable or the directory is not searchable by the owner, and the
|
||||
set-user-id bit is set.
|
||||
.It S
|
||||
If the character is part of the group permissions and the file is not
|
||||
executable or the directory is not searchable by the group, and the
|
||||
set-group-id bit is set.
|
||||
.It T
|
||||
If the character is part of the other permissions and the file is not
|
||||
executable or the directory is not searchable by others, and the ``sticky''
|
||||
.Pq Dv S_ISVTX
|
||||
bit is set.
|
||||
.It s
|
||||
If the character is part of the owner permissions and the file is
|
||||
executable or the directory searchable by the owner, and the set-user-id
|
||||
bit is set.
|
||||
.It s
|
||||
If the character is part of the group permissions and the file is
|
||||
executable or the directory searchable by the group, and the set-group-id
|
||||
bit is set.
|
||||
.It t
|
||||
If the character is part of the other permissions and the file is
|
||||
executable or the directory searchable by others, and the ``sticky''
|
||||
.Pq Dv S_ISVTX
|
||||
bit is set.
|
||||
.It x
|
||||
The file is executable or the directory is searchable.
|
||||
.It \-
|
||||
None of the above apply.
|
||||
.El
|
||||
.Pp
|
||||
The last character is a plus sign ``+'' if any there are any alternate
|
||||
or additional access control methods associated with the inode, otherwise
|
||||
it will be a space.
|
||||
.Sh SEE ALSO
|
||||
.Xr chmod 1 ,
|
||||
.Xr find 1 ,
|
||||
.Xr stat 2 ,
|
||||
.Xr getmode 3 ,
|
||||
.Xr setmode 3
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Fn strmode
|
||||
function first appeared in
|
||||
.Bx 4.4 .
|
||||
149
src/strmode.c
Normal file
149
src/strmode.c
Normal file
@ -0,0 +1,149 @@
|
||||
/*-
|
||||
* Copyright (c) 1990, 1993
|
||||
* The Regents of the University of California. All rights reserved.
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
* are met:
|
||||
* 1. Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* 2. Redistributions in binary form must reproduce the above copyright
|
||||
* notice, this list of conditions and the following disclaimer in the
|
||||
* documentation and/or other materials provided with the distribution.
|
||||
* 4. Neither the name of the University nor the names of its contributors
|
||||
* may be used to endorse or promote products derived from this software
|
||||
* without specific prior written permission.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
* SUCH DAMAGE.
|
||||
*/
|
||||
|
||||
#if defined(LIBC_SCCS) && !defined(lint)
|
||||
static char sccsid[] = "@(#)strmode.c 8.3 (Berkeley) 8/15/94";
|
||||
#endif /* LIBC_SCCS and not lint */
|
||||
#include <sys/cdefs.h>
|
||||
|
||||
#include <sys/types.h>
|
||||
#include <sys/stat.h>
|
||||
#include <string.h>
|
||||
|
||||
void
|
||||
strmode(mode, p)
|
||||
mode_t mode;
|
||||
char *p;
|
||||
{
|
||||
/* print type */
|
||||
switch (mode & S_IFMT) {
|
||||
case S_IFDIR: /* directory */
|
||||
*p++ = 'd';
|
||||
break;
|
||||
case S_IFCHR: /* character special */
|
||||
*p++ = 'c';
|
||||
break;
|
||||
case S_IFBLK: /* block special */
|
||||
*p++ = 'b';
|
||||
break;
|
||||
case S_IFREG: /* regular */
|
||||
*p++ = '-';
|
||||
break;
|
||||
case S_IFLNK: /* symbolic link */
|
||||
*p++ = 'l';
|
||||
break;
|
||||
case S_IFSOCK: /* socket */
|
||||
*p++ = 's';
|
||||
break;
|
||||
#ifdef S_IFIFO
|
||||
case S_IFIFO: /* fifo */
|
||||
*p++ = 'p';
|
||||
break;
|
||||
#endif
|
||||
#ifdef S_IFWHT
|
||||
case S_IFWHT: /* whiteout */
|
||||
*p++ = 'w';
|
||||
break;
|
||||
#endif
|
||||
default: /* unknown */
|
||||
*p++ = '?';
|
||||
break;
|
||||
}
|
||||
/* usr */
|
||||
if (mode & S_IRUSR)
|
||||
*p++ = 'r';
|
||||
else
|
||||
*p++ = '-';
|
||||
if (mode & S_IWUSR)
|
||||
*p++ = 'w';
|
||||
else
|
||||
*p++ = '-';
|
||||
switch (mode & (S_IXUSR | S_ISUID)) {
|
||||
case 0:
|
||||
*p++ = '-';
|
||||
break;
|
||||
case S_IXUSR:
|
||||
*p++ = 'x';
|
||||
break;
|
||||
case S_ISUID:
|
||||
*p++ = 'S';
|
||||
break;
|
||||
case S_IXUSR | S_ISUID:
|
||||
*p++ = 's';
|
||||
break;
|
||||
}
|
||||
/* group */
|
||||
if (mode & S_IRGRP)
|
||||
*p++ = 'r';
|
||||
else
|
||||
*p++ = '-';
|
||||
if (mode & S_IWGRP)
|
||||
*p++ = 'w';
|
||||
else
|
||||
*p++ = '-';
|
||||
switch (mode & (S_IXGRP | S_ISGID)) {
|
||||
case 0:
|
||||
*p++ = '-';
|
||||
break;
|
||||
case S_IXGRP:
|
||||
*p++ = 'x';
|
||||
break;
|
||||
case S_ISGID:
|
||||
*p++ = 'S';
|
||||
break;
|
||||
case S_IXGRP | S_ISGID:
|
||||
*p++ = 's';
|
||||
break;
|
||||
}
|
||||
/* other */
|
||||
if (mode & S_IROTH)
|
||||
*p++ = 'r';
|
||||
else
|
||||
*p++ = '-';
|
||||
if (mode & S_IWOTH)
|
||||
*p++ = 'w';
|
||||
else
|
||||
*p++ = '-';
|
||||
switch (mode & (S_IXOTH | S_ISVTX)) {
|
||||
case 0:
|
||||
*p++ = '-';
|
||||
break;
|
||||
case S_IXOTH:
|
||||
*p++ = 'x';
|
||||
break;
|
||||
case S_ISVTX:
|
||||
*p++ = 'T';
|
||||
break;
|
||||
case S_IXOTH | S_ISVTX:
|
||||
*p++ = 't';
|
||||
break;
|
||||
}
|
||||
*p++ = ' '; /* will be a '+' if ACL's implemented */
|
||||
*p = '\0';
|
||||
}
|
||||
Loading…
x
Reference in New Issue
Block a user