source: trunk/third/moira/man/blanche.1 @ 25817

Revision 25817, 8.6 KB checked in by jdreed, 12 years ago (diff)
In moira: * Re-snapshot moira at r4097 to pick up Status 10 (Suspended) (Trac: #1295) * Remove our addusr.1 and namespace.1 in favor of upstreams (Trac: #918) * Build-dep on OpenSSL and pass new configure flag per moira r4091
Line 
1.TH BLANCHE 1 "31 Jul 2012" "Project Athena"
2\" RCSID: $HeadURL: svn+ssh://svn.mit.edu/moira/trunk/moira/man/blanche.1 $ $Id: blanche.1 4083 2012-08-06 15:54:53Z zacheiss $
3.SH NAME
4blanche \- examine and modify memberships in Moira lists
5.SH SYNOPSIS
6.B blanche listname [options]
7.SH DESCRIPTION
8.I Blanche
9is a tool for maintaining the membership of Moira lists.  It is more
10limited than the menu-oriented listmaint, but has a more traditional
11unix user interface which makes it easier to use in scripts.  It can
12also read a set of list members from a file and synchronize the list
13in Moira to that file.
14
15Whenever a member is specified, it may be specified explicitly, as
16user:username, list:listname, string:string_text, or
17kerberos:principal_name; or the type may
18be left off if the member name is non ambiguous.  A member having
19punctuation characters (such as at-sign) in it is immediately assumed
20to be a string.  Otherwise,
21.B blanche
22will try first as a user, and if that fails will try the member as a
23list, and finally fall back to string if both of those fail.
24
25The default output mode is similar, in that usernames are displayed
26without any identifying type, lists are always displayed as
27list:listname, and strings will only be labeled as a string if they do
28not have any punctuation characters in them.  Kerberos members will
29always have the type displayed.
30.SH OPTIONS
31.IP \fB-add\ \fImember\ \fRor\ \fB-a\ \fImember\fR
32This will add the specified member to the target list.  This option
33may be specified multiple times with different members on the same
34command line.
35.IP \fB-delete\ \fImember\ \fRor\ \fB-d\ \fImember\fR
36This will delete the specified member from the target list.  This
37option may be specified multiple times with different members on the
38same command line.
39.IP \fB-file\ \fIfilename\ \fRor\ \fB-f\ \fIfilename\fR
40This will read a list of members from the named file, and make those
41members be the membership of the target list.  It will do this by
42extracting the current membership of the target list from Moira, then
43diff these two sets of members, and determine who has to be added and
44deleted from the list so it will match the contents of the file.
45
46The file contains one member per line.  It may have blank lines.
47Anything following a semicolon is considered a comment.  If the
48.I filename
49is "-",
50.B blanche
51will read from standard input.
52.IP \fB-info\ \fRor\ \fB-i\fR
53Display other information about the target list besides the
54membership.  This includes the description, flags, maillist and group
55status, owner, and last modification.
56.IP \fB-addlist\ \fIfilename\ \fRor\ \fB-al\ \fIfilename\fR
57This will read a list of members from the named file, and add those
58members to the target list.  The file format is specified above.
59.IP \fB-deletelist\ \fIfilename\ \fRor\ \fB-dl\ \fIfilename\fR
60This will read a list of members from the named file, and delete those
61members from the target list.  The file format is specified above.
62.IP \fB-members\ \fRor\ \fB-m\fR
63Display the membership of the target list.  This is the default if no
64other options are specified.
65.IP \fB-users\ \fRor\ \fB-u\fR
66Only display list members that are users (not lists or strings).  If
67none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is specified, then all
68of them will be displayed.
69.IP \fB-lists\ \fRor\ \fB-l\fR
70Only display list members that are lists (not users or strings).  If
71none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is specified, then all
72of them will be displayed.
73.IP \fB-strings\ \fRor\ \fB-s\fR
74Only display list members that are strings (not users or lists).  If
75none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is specified, then all
76of them will be displayed.
77.IP \fB-kerberos\ \fRor\ \fB-k\fR
78Only display list members that are Kerberos principals (not users,
79lists, or strings).  If
80none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is
81specified, then all of them will be displayed.
82.IP \fB-recursive\ \fRor\ \fB-r\fR
83When displaying the membership of the target list, recursively track
84down all lists that are members of the target, and get their
85membership.  Only the user and string members will be displayed, not
86the intermediate lists.
87.IP \fB-verbose\ \fRor\ \fB-v\fR
88Give more information.  With the info flag, it will also display the
89number of members on the list.  With the members flag, it will display
90the type of each member, not just those that are ambiguous.  When
91changing the membership of a list, it will print a message for each
92member added or deleted.
93.IP \fB-noauth\ \fRor\ \fB-n\fR
94Do not attempt to perform Kerberos authentication with the Moira server.
95Retrieval operations on not-hidden lists are still possible without
96tickets.
97.IP \fB-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR
98Use the specified host and port to contact the Moira database instead of
99the default server.  Both may be symbolic names or numbers.  If the
100port is left off, the default Moira server port will be assumed.  The
101database chosen will be the one specified on the command line, specified
102in the MOIRASERVER environment variable, the hesiod "moira" sloc entry,
103or the compiled in default, in that order or preference.
104.IP \fB-create\ \fRor\ \fB-C\fR
105Create the named list (assuming you have list-creation priviliges in
106Moira.) By default it will be active, private, visible, a mailing
107list, and not a group, although this can be changed with the flags
108below.
109.IP \fB-rename\ \fInewname\ \fRor\ \fB-R\ \fInewname\fR
110Rename the list to the new name.
111.IP \fB-public\ \fR(\fB-P\fR)\ \fRor\ \fB-private\ \fR(\fB-NP\fR)
112Make the list public or private. (Users can add themselves to public
113lists.)
114.IP \fB-active\ \fR(\fB-A\fR)\ \fRor\ \fB-inactive\ \fR(\fB-I\fR)
115Make the list active or inactive. (Inactive lists are not propagated
116to the mailhubs and fileservers.)
117.IP \fB-visible\ \fR(\fB-V\fR)\ \fRor\ \fB-hidden\ \fR(\fB-H\fR)
118Make the list visible or hidden. (Hidden lists are harder to find the
119membership and admistrators of.)
120.IP \fB-mail\ \fR(\fB-M\fR)\ \fRor\ \fB-notmail\ \fR(\fB-NM\fR)
121Toggle whether or not the list is a mailing list.
122.IP \fB-group\ \fR(\fB-G\fR)\ \fRor\ \fB-notgroup\ \fR(\fB-NG\fR)
123Toggle whether or not the list is a group. (Groups can be used on the
124ACLs of directories in AFS.)
125.IP \fB-nfs\ \fR(\fB-N\fR)\ \fRor\ \fB-notnfs\ \fR(\fB-NN\fR)
126Toggle whether or not the list is an NFS group.  (NFS groups are
127included in a user's hesiod group list and in Moira-generated NFS
128credentials file, and can be used for controlling access to NFS exported
129filesystems.)
130.IP \fB-desc\ \fIdescription\ \fRor\ \fB-D\ \fIdescription\fR
131Set the description of the list.
132.IP \fB-owner\ \fIowner\ \fRor\ \fB-O\ \fIowner\fR
133Set the owner of the list. The owner is specified like a list member,
134except that list owners can never be strings.
135.IP \fB-memacl\ \fImembership_acl\ \fRor\ \fB-MA\ \fImembership_acl\fR
136Set the mebership acl of the list; members of this acl will be allowed
137to add and remove members of the list, but not update any other
138characteristics. The membership acl is specified like a list member,
139except that it can never be a string.
140To return a list to having default membership access control
141conditions, set the membership acl to "NONE".
142.IP \fB-tags\ \fRor\ \fB-t\fR
143Display 'tags' in parentheses next to each entry, where applicable.
144Tags are used when converting lists to Athena 9 access files or Discuss
145meeting ACLs.
146.IP \fB-addtagged\ \fImember\ tag\ \fRor\ \fB-at\ \fImember\ tag\fR
147This will add the specified member to the target list with the
148specified tag. 
149.IP \fB-changetag\ \fImember\ tag\ \fRor\ \fB-ct\ \fImember\ tag\fR
150This will change the specified member's tag to the specified tag.  You
151may specify an empty string to clear an existing tag.
152.IP \fB-mailman\ \fR(\fB-mm\fR)\ \fRor\ \fB-notmailman\ \fR(\fB-nmm\fR)
153Toggle whether or not the list is a Mailman list.  Mailman lists cannot
154also be used as groups or NFS groups.
155.IP \fB-mailman_server\ \fIserver\ \fRor\ \fB-ms\ \fIserver\fR
156Use the specified server instead of the default when making a list a
157mailman list.
158
159.SH AUTHORS
160Mark Rosenstein and Jay Berkenbilt.
161.SH SEE ALSO
162listmaint(1)
163
164.SH DIAGNOSTICS
165The exit status from blanche is not as useful as you might hope. An
166exit status of 2 indicates a problem contacting the server or reading
167an input file. An exit status of 1 indicates that at least one add or
168delete failed, and an exit status of 0 indicates that all adds and
169deletes succeeded. If you need the exit status to be meaningful, you
170should only do one add or delete at a time.
171
172.SH NOTES
173The listname doesn't actually have to be the first argument, but if
174you put it anywhere else, it's easy to get the other arguments in the
175wrong order and do something other than what you intended.
Note: See TracBrowser for help on using the repository browser.