summaryrefslogtreecommitdiffabout
path: root/doc/eclat-setsattr.1
blob: 94167189f949befd2cb25396dbbfd5526b15350e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
.\" This file is part of Eclat -*- nroff -*-
.\" Copyright (C) 2012, 2013 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 SETSATTR 1 "April 23, 2013" "ECLAT" "Eclat User Reference"
.SH NAME
eclat setsattr, modify\-snapshot\-attribute \- modify permission settings for the specified snapshot. 
.SH SYNOPSIS
\fBeclat setsattr\fB\
 {\fBg\fR|\fBu\fR}{\fB\-\fR|\fB+\fR}{\fBall\fR|\fBID\fR}\
 \fISNAP-ID\fR

\fBeclat setsattr\fB \fB\-\-help\fR
.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, 2013 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:

Return to:

Send suggestions and report system problems to the System administrator.