Blame getcifsacl.c

Packit 5f9837
/*
Packit 5f9837
* getcifsacl utility
Packit 5f9837
*
Packit 5f9837
* Copyright (C) Shirish Pargaonkar (shirishp@us.ibm.com) 2011
Packit 5f9837
*
Packit 5f9837
* Used to display a security descriptor including ACL of a file object
Packit 5f9837
* that belongs to a share mounted using option cifsacl.
Packit 5f9837
*
Packit 5f9837
* This program is free software; you can redistribute it and/or modify
Packit 5f9837
* it under the terms of the GNU General Public License as published by
Packit 5f9837
* the Free Software Foundation; either version 2 of the License, or
Packit 5f9837
* (at your option) any later version.
Packit 5f9837
* This program is distributed in the hope that it will be useful,
Packit 5f9837
* but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 5f9837
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
Packit 5f9837
* GNU General Public License for more details.
Packit 5f9837
* You should have received a copy of the GNU General Public License
Packit 5f9837
* along with this program; if not, write to the Free Software
Packit 5f9837
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Packit 5f9837
*/
Packit 5f9837
Packit 5f9837
#ifdef HAVE_CONFIG_H
Packit 5f9837
#include "config.h"
Packit 5f9837
#endif /* HAVE_CONFIG_H */
Packit 5f9837
Packit 5f9837
#include <string.h>
Packit 5f9837
#include <getopt.h>
Packit 5f9837
#include <stdint.h>
Packit 5f9837
#include <stdbool.h>
Packit 5f9837
#include <unistd.h>
Packit 5f9837
#include <stdio.h>
Packit 5f9837
#include <stdlib.h>
Packit 5f9837
#include <stddef.h>
Packit 5f9837
#include <errno.h>
Packit 5f9837
#include <limits.h>
Packit 5f9837
#include <ctype.h>
Packit 5f9837
#include <sys/xattr.h>
Packit 5f9837
#include "cifsacl.h"
Packit 5f9837
#include "idmap_plugin.h"
Packit 5f9837
Packit 5f9837
static void *plugin_handle;
Packit 5f9837
static bool plugin_loaded;
Packit Service af09dd
static char *execname;
Packit 5f9837
Packit 5f9837
static void
Packit 5f9837
print_each_ace_mask(uint32_t mask)
Packit 5f9837
{
Packit 5f9837
	if ((mask & ALL_READ_BITS) && ((mask & EREAD) != EREAD &&
Packit 5f9837
			(mask & OREAD) != OREAD && (mask & BREAD) != BREAD)) {
Packit 5f9837
		printf("0x%x", mask);
Packit 5f9837
		return;
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	if ((mask & ALL_WRITE_BITS) && (mask & EWRITE) != EWRITE) {
Packit 5f9837
		printf("0x%x", mask);
Packit 5f9837
		return;
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	if ((mask & EREAD) == EREAD || (mask & OREAD) == OREAD ||
Packit 5f9837
			(mask & BREAD) == BREAD)
Packit 5f9837
		printf("R");
Packit 5f9837
	if ((mask & EWRITE) == EWRITE)
Packit 5f9837
		printf("W");
Packit 5f9837
	if ((mask & EXEC) == EXEC)
Packit 5f9837
		printf("X");
Packit 5f9837
	if ((mask & DELETE) == DELETE)
Packit 5f9837
		printf("D");
Packit 5f9837
	if ((mask & WRITE_DAC) == WRITE_DAC)
Packit 5f9837
		printf("P");
Packit 5f9837
	if ((mask & WRITE_OWNER) == WRITE_OWNER)
Packit 5f9837
		printf("O");
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
static void
Packit 5f9837
print_ace_mask(uint32_t mask, int raw)
Packit 5f9837
{
Packit 5f9837
	if (raw) {
Packit 5f9837
		printf("0x%x\n", mask);
Packit 5f9837
		return;
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	if (mask == FULL_CONTROL)
Packit 5f9837
		printf("FULL");
Packit 5f9837
	else if (mask == CHANGE)
Packit 5f9837
		printf("CHANGE");
Packit 5f9837
	else if (mask == DELETE)
Packit 5f9837
		printf("D");
Packit 5f9837
	else if (mask == EREAD)
Packit 5f9837
		printf("READ");
Packit 5f9837
	else if (mask & DELDHLD)
Packit 5f9837
		printf("0x%x", mask);
Packit 5f9837
	else
Packit 5f9837
		print_each_ace_mask(mask);
Packit 5f9837
Packit 5f9837
	printf("\n");
Packit 5f9837
	return;
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
static void
Packit 5f9837
print_ace_flags(uint8_t flags, int raw)
Packit 5f9837
{
Packit 5f9837
	bool mflags = false;
Packit 5f9837
Packit 5f9837
	if (raw) {
Packit 5f9837
		printf("0x%x", flags);
Packit 5f9837
		return;
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	if (flags & OBJECT_INHERIT_FLAG) {
Packit 5f9837
		mflags = true;
Packit 5f9837
		printf("OI");
Packit 5f9837
	}
Packit 5f9837
	if (flags & CONTAINER_INHERIT_FLAG) {
Packit 5f9837
		if (mflags)
Packit 5f9837
			printf("|");
Packit 5f9837
		else
Packit 5f9837
			mflags = true;
Packit 5f9837
		printf("CI");
Packit 5f9837
	}
Packit 5f9837
	if (flags & NO_PROPAGATE_INHERIT_FLAG) {
Packit 5f9837
		if (mflags)
Packit 5f9837
			printf("|");
Packit 5f9837
		else
Packit 5f9837
			mflags = true;
Packit 5f9837
		printf("NP");
Packit 5f9837
	}
Packit 5f9837
	if (flags & INHERIT_ONLY_FLAG) {
Packit 5f9837
		if (mflags)
Packit 5f9837
			printf("|");
Packit 5f9837
		else
Packit 5f9837
			mflags = true;
Packit 5f9837
		printf("IO");
Packit 5f9837
	}
Packit 5f9837
	if (flags & INHERITED_ACE_FLAG) {
Packit 5f9837
		if (mflags)
Packit 5f9837
			printf("|");
Packit 5f9837
		else
Packit 5f9837
			mflags = true;
Packit 5f9837
		printf("I");
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	if (!mflags)
Packit 5f9837
		printf("0x0");
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
static void
Packit 5f9837
print_ace_type(uint8_t acetype, int raw)
Packit 5f9837
{
Packit 5f9837
	if (raw) {
Packit 5f9837
		printf("0x%x", acetype);
Packit 5f9837
		return;
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	switch (acetype) {
Packit 5f9837
	case ACCESS_ALLOWED:
Packit 5f9837
		printf("ALLOWED");
Packit 5f9837
		break;
Packit 5f9837
	case ACCESS_DENIED:
Packit 5f9837
		printf("DENIED");
Packit 5f9837
		break;
Packit 5f9837
	case ACCESS_ALLOWED_OBJECT:
Packit 5f9837
		printf("OBJECT_ALLOWED");
Packit 5f9837
		break;
Packit 5f9837
	case ACCESS_DENIED_OBJECT:
Packit 5f9837
		printf("OBJECT_DENIED");
Packit 5f9837
		break;
Packit 5f9837
	default:
Packit 5f9837
		printf("UNKNOWN");
Packit 5f9837
		break;
Packit 5f9837
	}
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
static void
Packit 5f9837
print_sid(struct cifs_sid *csid, int raw)
Packit 5f9837
{
Packit 5f9837
	int i, rc;
Packit 5f9837
	char *name;
Packit 5f9837
	unsigned long long id_auth_val;
Packit 5f9837
Packit 5f9837
	if (raw || !plugin_loaded)
Packit 5f9837
		goto print_sid_raw;
Packit 5f9837
Packit 5f9837
	rc = sid_to_str(plugin_handle, csid, &name);
Packit 5f9837
	if (rc)
Packit 5f9837
		goto print_sid_raw;
Packit 5f9837
Packit 5f9837
	printf("%s", name);
Packit 5f9837
	free(name);
Packit 5f9837
	return;
Packit 5f9837
Packit 5f9837
print_sid_raw:
Packit 5f9837
	printf("S-%hhu", csid->revision);
Packit 5f9837
Packit 5f9837
	id_auth_val = (unsigned long long)csid->authority[5];
Packit 5f9837
	id_auth_val += (unsigned long long)csid->authority[4] << 8;
Packit 5f9837
	id_auth_val += (unsigned long long)csid->authority[3] << 16;
Packit 5f9837
	id_auth_val += (unsigned long long)csid->authority[2] << 24;
Packit 5f9837
	id_auth_val += (unsigned long long)csid->authority[1] << 32;
Packit 5f9837
	id_auth_val += (unsigned long long)csid->authority[0] << 40;
Packit 5f9837
Packit 5f9837
	/*
Packit 5f9837
	 * MS-DTYP states that if the authority is >= 2^32, then it should be
Packit 5f9837
	 * expressed as a hex value.
Packit 5f9837
	 */
Packit 5f9837
	if (id_auth_val <= UINT_MAX)
Packit 5f9837
		printf("-%llu", id_auth_val);
Packit 5f9837
	else
Packit 5f9837
		printf("-0x%llx", id_auth_val);
Packit 5f9837
Packit 5f9837
	for (i = 0; i < csid->num_subauth; i++)
Packit 5f9837
		printf("-%u", le32toh(csid->sub_auth[i]));
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
static void
Packit 5f9837
print_ace(struct cifs_ace *pace, char *end_of_acl, int raw)
Packit 5f9837
{
Packit 5f9837
	uint16_t size;
Packit 5f9837
Packit 5f9837
	/* make sure we can safely get to "size" */
Packit 5f9837
	if (end_of_acl < (char *)pace + offsetof(struct cifs_ace, size) + 1)
Packit 5f9837
		return;
Packit 5f9837
Packit 5f9837
	size = le16toh(pace->size);
Packit 5f9837
Packit 5f9837
	/* 16 == size of cifs_ace when cifs_sid has no subauths */
Packit 5f9837
	if (size < 16)
Packit 5f9837
		return;
Packit 5f9837
Packit 5f9837
	/* validate that we do not go past end of acl */
Packit 5f9837
	if (end_of_acl < (char *)pace + size)
Packit 5f9837
		return;
Packit 5f9837
Packit 5f9837
	printf("ACL:");
Packit 5f9837
	print_sid((struct cifs_sid *)&pace->sid, raw);
Packit 5f9837
	printf(":");
Packit 5f9837
	print_ace_type(pace->type, raw);
Packit 5f9837
	printf("/");
Packit 5f9837
	print_ace_flags(pace->flags, raw);
Packit 5f9837
	printf("/");
Packit 5f9837
	print_ace_mask(le32toh(pace->access_req), raw);
Packit 5f9837
Packit 5f9837
	return;
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
static void
Packit 5f9837
parse_dacl(struct cifs_ctrl_acl *pdacl, char *end_of_acl, int raw)
Packit 5f9837
{
Packit 5f9837
	int i;
Packit 5f9837
	int num_aces = 0;
Packit 5f9837
	int acl_size;
Packit 5f9837
	char *acl_base;
Packit 5f9837
	struct cifs_ace *pace;
Packit 5f9837
Packit 5f9837
	if (!pdacl)
Packit 5f9837
		return;
Packit 5f9837
Packit 5f9837
	if (end_of_acl < (char *)pdacl + le16toh(pdacl->size))
Packit 5f9837
		return;
Packit 5f9837
Packit 5f9837
	acl_base = (char *)pdacl;
Packit 5f9837
	acl_size = sizeof(struct cifs_ctrl_acl);
Packit 5f9837
Packit 5f9837
	num_aces = le32toh(pdacl->num_aces);
Packit 5f9837
	if (num_aces  > 0) {
Packit 5f9837
		for (i = 0; i < num_aces; ++i) {
Packit 5f9837
			pace = (struct cifs_ace *) (acl_base + acl_size);
Packit 5f9837
			print_ace(pace, end_of_acl, raw);
Packit 5f9837
			acl_base = (char *)pace;
Packit 5f9837
			acl_size = le16toh(pace->size);
Packit 5f9837
		}
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	return;
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
static int
Packit 5f9837
parse_sid(struct cifs_sid *psid, char *end_of_acl, char *title, int raw)
Packit 5f9837
{
Packit 5f9837
	if (end_of_acl < (char *)psid + 8)
Packit 5f9837
		return -EINVAL;
Packit 5f9837
Packit 5f9837
	if (title)
Packit 5f9837
		printf("%s:", title);
Packit 5f9837
	print_sid((struct cifs_sid *)psid, raw);
Packit 5f9837
	printf("\n");
Packit 5f9837
Packit 5f9837
	return 0;
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
static int
Packit 5f9837
parse_sec_desc(struct cifs_ntsd *pntsd, ssize_t acl_len, int raw)
Packit 5f9837
{
Packit 5f9837
	int rc;
Packit 5f9837
	uint32_t dacloffset;
Packit 5f9837
	char *end_of_acl = ((char *)pntsd) + acl_len;
Packit 5f9837
	struct cifs_sid *owner_sid_ptr, *group_sid_ptr;
Packit 5f9837
	struct cifs_ctrl_acl *dacl_ptr; /* no need for SACL ptr */
Packit 5f9837
Packit 5f9837
	if (pntsd == NULL)
Packit 5f9837
		return -EIO;
Packit 5f9837
Packit 5f9837
	owner_sid_ptr = (struct cifs_sid *)((char *)pntsd +
Packit 5f9837
				le32toh(pntsd->osidoffset));
Packit 5f9837
	group_sid_ptr = (struct cifs_sid *)((char *)pntsd +
Packit 5f9837
				le32toh(pntsd->gsidoffset));
Packit 5f9837
	dacloffset = le32toh(pntsd->dacloffset);
Packit 5f9837
	dacl_ptr = (struct cifs_ctrl_acl *)((char *)pntsd + dacloffset);
Packit 5f9837
	printf("REVISION:0x%x\n", le16toh(pntsd->revision));
Packit 5f9837
	printf("CONTROL:0x%x\n", le16toh(pntsd->type));
Packit 5f9837
Packit 5f9837
	rc = parse_sid(owner_sid_ptr, end_of_acl, "OWNER", raw);
Packit 5f9837
	if (rc)
Packit 5f9837
		return rc;
Packit 5f9837
Packit 5f9837
	rc = parse_sid(group_sid_ptr, end_of_acl, "GROUP", raw);
Packit 5f9837
	if (rc)
Packit 5f9837
		return rc;
Packit 5f9837
Packit 5f9837
	if (dacloffset)
Packit 5f9837
		parse_dacl(dacl_ptr, end_of_acl, raw);
Packit 5f9837
	else
Packit 5f9837
		printf("No ACL\n"); /* BB grant all or default perms? */
Packit 5f9837
Packit 5f9837
	return 0;
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
static void
Packit 5f9837
getcifsacl_usage(const char *prog)
Packit 5f9837
{
Packit 5f9837
	fprintf(stderr,
Packit 5f9837
	"%s: Display CIFS/NTFS ACL in a security descriptor of a file object\n",
Packit 5f9837
		prog);
Packit 5f9837
	fprintf(stderr, "Usage: %s [option] <file_name>\n", prog);
Packit 5f9837
	fprintf(stderr, "Valid options:\n");
Packit Service af09dd
	fprintf(stderr, "\t-h	Display this help text\n");
Packit Service af09dd
	fprintf(stderr, "\n");
Packit 5f9837
	fprintf(stderr, "\t-v	Version of the program\n");
Packit 5f9837
	fprintf(stderr, "\n");
Packit 5f9837
	fprintf(stderr, "\t-r	Display raw values of the ACE fields\n");
Packit 5f9837
	fprintf(stderr, "\nRefer to getcifsacl(1) manpage for details\n");
Packit 5f9837
}
Packit 5f9837
Packit 5f9837
int
Packit 5f9837
main(const int argc, char *const argv[])
Packit 5f9837
{
Packit 5f9837
	int c, ret = 0;
Packit 5f9837
	bool raw = false;
Packit 5f9837
	ssize_t attrlen;
Packit 5f9837
	size_t bufsize = BUFSIZE;
Packit 5f9837
	char *filename, *attrval;
Packit Service af09dd
	execname = basename(argv[0]);
Packit Service af09dd
Packit Service af09dd
	if (argc < 2) {
Packit Service af09dd
		fprintf(stderr, "%s: you must specify a filename.\n", execname);
Packit Service af09dd
		printf("Try `getcifsacl -h' for more information.\n");
Packit Service af09dd
		goto out;
Packit Service af09dd
	}
Packit fc12d5
Packit Service af09dd
	while ((c = getopt_long(argc, argv, "rhv", NULL, NULL)) != -1) {
Packit 5f9837
		switch (c) {
Packit 5f9837
		case 'v':
Packit 5f9837
			printf("Version: %s\n", VERSION);
Packit 5f9837
			goto out;
Packit 5f9837
		case 'r':
Packit 5f9837
			raw = true;
Packit 5f9837
			break;
Packit 5f9837
		default:
Packit Service af09dd
			getcifsacl_usage(execname);
Packit Service af09dd
			goto out;
Packit 5f9837
		}
Packit 5f9837
	}
Packit 5f9837
Packit Service af09dd
	if (optind >= argc) {
Packit Service af09dd
		printf("you must specify a filename after options.\n");
Packit Service af09dd
		printf("Usage: getcifsacl [option] <file_name>\n");
Packit 5f9837
		goto out;
Packit Service af09dd
	} else
Packit Service af09dd
		filename = argv[optind];
Packit 5f9837
Packit 5f9837
	if (!raw && !plugin_loaded) {
Packit 5f9837
		ret = init_plugin(&plugin_handle);
Packit 5f9837
		if (ret)
Packit 5f9837
			printf("WARNING: unable to initialize idmapping plugin: %s\n",
Packit 5f9837
				plugin_errmsg);
Packit 5f9837
		else
Packit 5f9837
			plugin_loaded = true;
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
cifsacl:
Packit 5f9837
	if (bufsize >= XATTR_SIZE_MAX) {
Packit 5f9837
		printf("buffer to allocate exceeds max size of %d\n",
Packit 5f9837
				XATTR_SIZE_MAX);
Packit 5f9837
		ret = -1;
Packit 5f9837
		goto out;
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	attrval = malloc(bufsize * sizeof(char));
Packit 5f9837
	if (!attrval) {
Packit 5f9837
		printf("error allocating memory for attribute value buffer\n");
Packit 5f9837
		ret = -1;
Packit 5f9837
		goto out;
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	attrlen = getxattr(filename, ATTRNAME, attrval, bufsize);
Packit 5f9837
	if (attrlen == -1) {
Packit 5f9837
		if (errno == ERANGE) {
Packit 5f9837
			free(attrval);
Packit 5f9837
			bufsize += BUFSIZE;
Packit 5f9837
			goto cifsacl;
Packit Service 559289
		} else {
Packit Service 559289
			fprintf(stderr, "getxattr failed on %s: %s\n", filename, strerror(errno) );
Packit Service 559289
			free(attrval);
Packit Service 559289
			ret = -1;
Packit Service 559289
			goto out;
Packit Service 559289
		}
Packit 5f9837
	}
Packit 5f9837
Packit 5f9837
	parse_sec_desc((struct cifs_ntsd *)attrval, attrlen, raw);
Packit 5f9837
Packit 5f9837
	free(attrval);
Packit 5f9837
out:
Packit 5f9837
	if (plugin_loaded)
Packit 5f9837
		exit_plugin(plugin_handle);
Packit 5f9837
	return ret;
Packit 5f9837
}