From patchwork Tue Aug 23 19:04:10 2011 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Shirish Pargaonkar X-Patchwork-Id: 1089462 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by demeter1.kernel.org (8.14.4/8.14.4) with ESMTP id p7NIw3oJ009681 for ; Tue, 23 Aug 2011 18:58:40 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755720Ab1HWS6h (ORCPT ); Tue, 23 Aug 2011 14:58:37 -0400 Received: from mail-gx0-f174.google.com ([209.85.161.174]:53254 "EHLO mail-gx0-f174.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755726Ab1HWS6g (ORCPT ); Tue, 23 Aug 2011 14:58:36 -0400 Received: by mail-gx0-f174.google.com with SMTP id 21so323475gxk.19 for ; Tue, 23 Aug 2011 11:58:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:cc:subject:date:message-id:x-mailer; bh=DcSlbpqr+czpx9X1lLr2SOFCKxU619VZ/wSwaEcD//A=; b=mnR7FgGqLZ3T5WXlSrE9ecTfTkNMKVUI1Z9Vww/T83qvzjCG0npqGYixMU0PYPZ5b9 ovJpl7A5YYRE96mA35WBT7EcgmXlK/CN7lMHYTQ35VfLB/N9Cie7JwPU015+8mtyIycY Ken4q3dEjd5UUcHQyK3QI+rv+Cu+1PaE71EMU= Received: by 10.236.119.164 with SMTP id n24mr16318730yhh.115.1314125916312; Tue, 23 Aug 2011 11:58:36 -0700 (PDT) Received: from localhost ([32.97.110.58]) by mx.google.com with ESMTPS id j45sm315509yhe.50.2011.08.23.11.58.35 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 23 Aug 2011 11:58:35 -0700 (PDT) From: shirishpargaonkar@gmail.com To: jlayton@samba.org Cc: linux-cifs@vger.kernel.org, Shirish Pargaonkar Subject: [PATCH 5/8] cifs-utils: cifsacl utilities: Add man pages for setcifsacl (try #5) Date: Tue, 23 Aug 2011 14:04:10 -0500 Message-Id: <1314126250-12061-1-git-send-email-shirishpargaonkar@gmail.com> X-Mailer: git-send-email 1.6.0.2 Sender: linux-cifs-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-cifs@vger.kernel.org X-Greylist: IP, sender and recipient auto-whitelisted, not delayed by milter-greylist-4.2.6 (demeter1.kernel.org [140.211.167.41]); Tue, 23 Aug 2011 18:58:40 +0000 (UTC) From: Shirish Pargaonkar Man pages for utility setcifsacl. Signed-off-by: Shirish Pargaonkar --- setcifsacl.8.in | 104 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 104 insertions(+), 0 deletions(-) create mode 100644 setcifsacl.8.in diff --git a/setcifsacl.8.in b/setcifsacl.8.in new file mode 100644 index 0000000..98ab0ac --- /dev/null +++ b/setcifsacl.8.in @@ -0,0 +1,104 @@ +'\" t +.\" Title: cifs.idmap +.\" Author: [see the "AUTHOR" section] +.\" Generator: DocBook XSL Stylesheets v1.75.2 +.\" Date: 08/19/2011 +.\" Manual: System Administration tools +.\" Source: cifs-utils 4.0 +.\" Language: English +.\" +.TH "SETCIFSACL" "8" "08/19/2011" "cifs-utils 4\&.0" "System Administration tools" +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" +setcifsacl \- Userspace helper to alter an ACL in a security descriptor for Common Internet File System (CIFS) +.SH "SYNOPSIS" +.HP \w'\ 'u +setcifsacl [\-v|\-a|\-D|\-M|\-S] "{one or more ACEs}" {file system object} +.SH "DESCRIPTION" +.PP +This tool is part of the cifs-utils suite\&. +.PP +setcifsacl is a userspace helper program for the Linux CIFS client file system. It is intended to alter an ACL of a security descriptor for a file system object. It is best utilized when an option of cifsacl is specified when mounting a cifs share in conjunction with winbind facility of Samba suite. Whether a security descriptor to be set is applied or not is determined by the CIFS/SMB server. +.SH "OPTIONS" +.PP +\-v +.RS 4 +Print version number and exit\&. +.RE +\-a +.RS 4 +Add one or more ACEs to an ACL of a security descriptor. +An ACE is added even if the same ACE exists in the ACL. +.RE +\-D +.RS 4 +Delete one or more ACEs from an ACL of a security descriptor. +Entire ACE has to match in an existing ACL for the listed ACEs to be deleted. +.RE +\-M +.RS 4 +Modify one or more ACEs from an ACL of a security descriptor. +SID and type are used to match for existing ACEs to be modified with the list of ACEs specified. +.RE +\-S +.RS 4 +Set an ACL of security descriptor with the list of ACEs +Existing ACL is replaced entirely with the specified ACEs. +.RE +.PP +Every ACE entry starts with "ACL:" +One or more ACEs are specified within double quotes. +Multiple ACEs are separated by a comma. +.PP +Following fields of an ACE can be modified with possible values: +.PP +SID: Either a name or a raw SID value. +.PP +type: ALLOWED (0x0), DENIED (0x1), OBJECT_ALLOWED (0x5), OBJECT_DENIED (0x6) +.PP +flags: OBJECT_INHERIT_FLAG (OI or 0x1), CONTAINER_INHERIT_FLAG (CI or 0x2), NO_PROPAGATE_INHERIT_FLAG (NI or 0x4), INHERIT_ONLY_FLAG (IO or 0x8), INHERITED_ACE_FLAG (IA or 0x10) or a combination/OR of these values. +.PP +mask: Either one of FULL, CHANGE, READ, a combination of R W X D P O, or a hex value +.SH "SEE ALSO" +.PP +\fBmount.cifs\fR(8), +\fBwinbindd\fR(8), +\fBgetcifsacl\fR(8) +.PP +.SH "EXAMPLES" +.PP +Add an ACE +.br +setcifsacl -a "ACL:CIFSTESTDOM\\user2:DENIED/0x1/D" +setcifsacl -a "ACL:CIFSTESTDOM\\user1:ALLOWED/OI|CI|NI/D" +.PP +Delete an ACE +.br +setcifsacl -D "ACL:S-1-1-0:0x1/OI/0x1201ff" +.PP +Modify an ACE +.br +setcifsacl -M "ACL:CIFSTESTDOM\\user1:ALLOWED/0x1f/CHANGE" +.PP +Set an ACL +.br +setcifsacl -S "ACL:CIFSTESTDOM\\Administrator:0x0/0x0/FULL, +.br +ACL:CIFSTESTDOM\\user2:0x0/0x0/FULL," +.PP +.SH "AUTHOR" +.PP +Shirish Pargaonkar wrote the setcifsacl program\&. +.PP +The +Linux CIFS Mailing list +is the preferred place to ask questions regarding these programs\&.