diff options
Diffstat (limited to 'usr.sbin/getextattr')
| -rw-r--r-- | usr.sbin/getextattr/Makefile | 6 | ||||
| -rw-r--r-- | usr.sbin/getextattr/getextattr.8 | 107 | ||||
| -rw-r--r-- | usr.sbin/getextattr/getextattr.c | 146 |
3 files changed, 259 insertions, 0 deletions
diff --git a/usr.sbin/getextattr/Makefile b/usr.sbin/getextattr/Makefile new file mode 100644 index 00000000000..fefa878b72a --- /dev/null +++ b/usr.sbin/getextattr/Makefile @@ -0,0 +1,6 @@ +# $OpenBSD: Makefile,v 1.1 2002/02/22 21:10:30 drahn Exp $ + +PROG= getextattr +MAN= getextattr.8 + +.include <bsd.prog.mk> diff --git a/usr.sbin/getextattr/getextattr.8 b/usr.sbin/getextattr/getextattr.8 new file mode 100644 index 00000000000..e5a1ae55b6e --- /dev/null +++ b/usr.sbin/getextattr/getextattr.8 @@ -0,0 +1,107 @@ +.\" $OpenBSD: getextattr.8,v 1.1 2002/02/22 21:10:30 drahn Exp $ +.\"- +.\" Copyright (c) 2000, 2001, 2002 Robert N. M. Watson +.\" All rights reserved. +.\" +.\" This software was developed by Robert Watson for the TrustedBSD +.\" Project. +.\" +.\" 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. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. +.\" +.\" $FreeBSD: getextattr.8,v 1.13 2002/02/10 06:13:14 rwatson Exp $ +.\" +.Dd March 30, 2000 +.Dt GETEXTATTR 8 +.Os +.Sh NAME +.Nm getextattr +.Nd retrieve a named extended attribute +.Sh SYNOPSIS +.Nm +.Op Fl ls +.Ar attrnamespace +.Ar attrname +.Ar filename ... +.Sh DESCRIPTION +.Nm +is a user tool to retrieve a named extended attribute on a file or +directory. +The +.Ar attrnamespace +argument should be the namespace of the attribute to retrieve: legal +values are "user" and "system". +The +.Ar attrname +argument should be the name of the attribute, and +.Ar filename +a list of files and directories from which to retrieve attribute data. +.Pp +The following options are available: +.Bl -tag -width indent +.It Fl l +Print attributes in the first column and file names in the second. +Can be used only in conjunction with the +.Fl s +option. +.It Fl s +Attempt to display the attribute data as a string, although the +results may not look pretty if the data is binary data. +The +.Xr strvisx 3 +function is used to generate the string, so control sequences should +be safely escaped. +Otherwise, the attribute data will be represented as a series of two-digit +hex numbers. +.El +.Sh IMPLEMENTATION NOTES +In order for +.Nm +to succeed, the attribute service must be available on the file system, +and the attribute must of defined for the file queried. +.Sh EXAMPLES +.Bd -literal -offset indent +# getextattr system md5 /kernel +/kernel: + 61 61 33 62 39 39 66 65 31 35 35 32 31 62 65 32 + 62 36 38 36 62 31 66 39 63 64 33 39 35 36 36 31 +# getextattr -s system md5 /kernel +/kernel: "aa3b99fe15521be2b686b1f9cd395661" +.Ed +.Pp +Retrieve the +.Dq md5 +extended attribute for the file +.Pa /kernel . +.Sh SEE ALSO +.Xr extattr 2 , +.Xr extattr 3 , +.Xr extattrctl 8 , +.Xr setextattr 8 , +.Xr extattr 9 +.Sh HISTORY +Extended attribute support was developed as part of the TrustedBSD Project. +It was developed to support security extensions requiring additional labels +to be associated with each file or directory. +.Sh AUTHORS +Robert N M Watson +.Sh BUGS +The output format for this utility is ugly, and worse yet, not very useful. diff --git a/usr.sbin/getextattr/getextattr.c b/usr.sbin/getextattr/getextattr.c new file mode 100644 index 00000000000..c7952bbc2ea --- /dev/null +++ b/usr.sbin/getextattr/getextattr.c @@ -0,0 +1,146 @@ +/* $OpenBSD: getextattr.c,v 1.1 2002/02/22 21:10:30 drahn Exp $ */ +/*- + * Copyright (c) 1999, 2000, 2001 Robert N. M. Watson + * 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. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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. + * + * $FreeBSD: getextattr.c,v 1.5 2001/06/24 20:25:17 dd Exp $ + */ +/* + * TrustedBSD Project - extended attribute support + */ +#include <sys/types.h> +#include <sys/uio.h> +#include <sys/extattr.h> + +#include <stdio.h> +#include <stdlib.h> +#include <unistd.h> +#include <vis.h> + +void +usage(void) +{ + + fprintf(stderr, "getextattr [-s] [attrnamespace] [attrname] " + "[filename ...]\n"); + exit(1); +} + +extern char *optarg; +extern int optind; + +#define BUFSIZE 2048 + +int +main(int argc, char **argv) +{ + size_t len; + char *attrname; + char *buf, *visbuf; + int ch, error, i, arg_counter, attrnamespace; + + int flag_as_string = 0; + int flag_reverse = 0; + + while ((ch = getopt(argc, argv, "ls")) != -1) { + switch (ch) { + case 'l': + flag_reverse = 1; + case 's': + flag_as_string = 1; + break; + case '?': + default: + usage(); + } + } + + argc -= optind; + argv += optind; + + if (argc < 3) + usage(); + + error = extattr_string_to_namespace(argv[0], &attrnamespace); + if (error) { + perror(argv[0]); + return (1); + } + attrname = argv[1]; + + argc--; + argv++; + + for (arg_counter = 1; arg_counter < argc; arg_counter++) { + len = extattr_get_file(argv[arg_counter], attrnamespace, + attrname, NULL, 0); + if (len == -1) { + perror(argv[arg_counter]); + continue; + } + buf = (char *)malloc(len); + if (buf == NULL) { + perror("malloc"); + return (1); + } + error = extattr_get_file(argv[arg_counter], attrnamespace, + attrname, buf, len); + + if (error == -1) + perror(argv[arg_counter]); + else { + if (flag_as_string) { + visbuf = (char *)malloc(len*4); + if (visbuf == NULL) { + perror("malloc"); + return (1); + } + + strvisx(visbuf, buf, error, VIS_SAFE + | VIS_WHITE); + if (flag_reverse) { + printf("%s ", visbuf); + printf("%s\n", argv[arg_counter]); + } else { + printf("%s:", argv[arg_counter]); + printf(" \"%s\"\n", visbuf); + } + free(visbuf); + } else { + printf("%s:", argv[arg_counter]); + for (i = 0; i < error; i++) + if (i % 16 == 0) + printf("\n %02x ", buf[i]); + else if (i % 8 == 0) + printf(" %02x ", buf[i]); + else + printf("%02x ", buf[i]); + printf("\n"); + } + } + free(buf); + } + + return (0); +} |