.\" This file is part of Eclat -*- nroff -*-
.\" Copyright (C) 2012-2018 Sergey Poznyakoff
.\"
.\" Eclat is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3, or (at your option)
.\" any later version.
.\"
.\" Eclat is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with Eclat.  If not, see <http://www.gnu.org/licenses/>.
.TH ECLAT-SETSATTR 1 "January 26, 2015" "ECLAT" "Eclat User Reference"
.SH NAME
eclat-setsattr, eclat-modify-snapshot-attribute \- modify permission settings for the specified snapshot. 
.SH SYNOPSIS
.nh
.na
\fBeclat setsattr\fB\
 {\fBg\fR|\fBu\fR}{\fB\-\fR|\fB+\fR}{\fBall\fR|\fBID\fR}\
 \fISNAP-ID\fR
.PP
\fBeclat setsattr\fB \fB\-\-help\fR
.ad
.hy
.SH DESCRIPTION
This command modifies the
.B createVolumePermission
attribute of a EC2 snapshot identified by \fISNAP-ID\fR.  If ID
mapping is enabled (see the section \fBMAPS\fR 
in
.BR eclat (1)),
the \fBSnapshotId\fR map will be used to translate \fISNAP-ID\fR to
the corresponding snapshot identifier.
.PP
The first argument requests the operation over the attribute.  It
consists of a letter indicating the identity (\fBu\fR for user or
\fBg\fR for group), followed by a plus sign to grant permission or a
minus sign to revoke it, and an ID of the identity.  For example, the
command
.PP
.EX
eclat setsattr u+111122223333 snap-1a2b3c4d
.EE
.PP
gives the account with ID \fB111122223333\fR permission to create volumes
from the snapshot.
.PP
Several operations can be requested in a single invocation, e.g.:
.PP
.EX
eclat setsattr g+all u-111122223333 snap-1a2b3c4d
.EE
.PP
The above example makes the snapshot public (\fBg+all\fR) and revokes
the permission to create volumes from it from the account
\fB111122223333\fR.
.SH "SEE ALSO"
.BR eclat (1),
.BR eclat\-clrsattr (1),
.BR eclat\-lssattr (1),
.BR eclat\-lsattr (1).
.SH AUTHORS
Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to <bug\-eclat@gnu.org.ua>.
.SH COPYRIGHT
Copyright \(co 2012-2015 Sergey Poznyakoff
.br
.na
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
.ad
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.\" Local variables:
.\" eval: (add-hook 'write-file-hooks 'time-stamp)
.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \""
.\" time-stamp-format: "%:B %:d, %:y"
.\" time-stamp-end: "\""
.\" time-stamp-line-limit: 20
.\" end: