X-Git-Url: http://andersk.mit.edu/gitweb/moira.git/blobdiff_plain/e6386401904c3420f29f99fd40df0f60b20ea628..refs/heads/LOCKING:/man/blanche.1 diff --git a/man/blanche.1 b/man/blanche.1 index 2bcc9cfc..e1ddbd31 100644 --- a/man/blanche.1 +++ b/man/blanche.1 @@ -1,19 +1,20 @@ .TH BLANCHE 1 "14 Sep 1988" "Project Athena" \" RCSID: $Header$ .SH NAME -blanche \- examine and modify memberships in SMS lists +blanche \- examine and modify memberships in Moira lists .SH SYNOPSIS -.B blanche [options] listname [options] +.B blanche listname [options] .SH DESCRIPTION .I Blanche -is a tool for maintaining the membership of SMS lists. It is more +is a tool for maintaining the membership of Moira lists. It is more limited than the menu-oriented listmaint, but has a more traditional unix user interface which makes it easier to use in scripts. It can also read a set of list members from a file and synchronize the list -in SMS to that file. +in Moira to that file. Whenever a member is specified, it may be specified explicitly, as -user:username, list:listname, or string:string_text; or the type may +user:username, list:listname, string:string_text, or +kerberos:principal_name; or the type may be left off if the member name is non ambiguous. A member having punctuation characters (such as at-sign) in it is immediately assumed to be a string. Otherwise, @@ -24,7 +25,8 @@ list, and finally fall back to string if both of those fail. The default output mode is similar, in that usernames are displayed without any identifying type, lists are always displayed as list:listname, and strings will only be labeled as a string if they do -not have any punctuation characters in them. +not have any punctuation characters in them. Kerberos members will +always have the type displayed. .SH OPTIONS .IP \fB-add\ \fImember\ \fRor\ \fB-a\ \fImember\fR: This will add the specified member to the target list. This option @@ -37,7 +39,7 @@ same command line. .IP \fB-file\ \fIfilename\ \fRor\ \fB-f\ \fIfilename\fR: This will read a list of members from the named file, and make those members be the membership of the target list. It will do this by -extracting the current membership of the target list from SMS, then +extracting the current membership of the target list from Moira, then diff these two sets of members, and determine who has to be added and deleted from the list so it will match the contents of the file. @@ -51,12 +53,35 @@ will read from standard input. Display other information about the target list besides the membership. This includes the description, flags, maillist and group status, owner, and last modification. +.IP \fB-addlist\ \fIfilename\ \fRor\ \fB-al\ \fIfilename\fR: +This will read a list of members from the named file, and add those +members to the target list. The file format is specified above. +.IP \fB-deletelist\ \fIfilename\ \fRor\ \fB-dl\ \fIfilename\fR: +This will read a list of members from the named file, and delete those +members from the target list. The file format is specified above. .IP \fB-members\ \fRor\ \fB-m\fR: Display the membership of the target list. This is the default if no other options are specified. +.IP \fB-users\ \fRor\ \fB-u\fR: +Only display list members that are users (not lists or strings). If +none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is specified, then all +of them will be displayed. +.IP \fB-lists\ \fRor\ \fB-l\fR: +Only display list members that are lists (not users or strings). If +none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is specified, then all +of them will be displayed. +.IP \fB-strings\ \fRor\ \fB-s\fR: +Only display list members that are strings (not users or lists). If +none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is specified, then all +of them will be displayed. +.IP \fB-kerberos\ \fRor\ \fB-k\fR: +Only display list members that are Kerberos principals (not users, +lists, or strings). If +none of \fB-users, -lists, -strings, \fRor \fB-kerberos\fR is +specified, then all of them will be displayed. .IP \fB-recursive\ \fRor\ \fB-r\fR: When displaying the membership of the target list, recursively track -down all lists which are members of the target, and get their +down all lists that are members of the target, and get their membership. Only the user and string members will be displayed, not the intermediate lists. .IP \fB-verbose\ \fRor\ \fB-v\fR: @@ -65,6 +90,17 @@ number of members on the list. With the members flag, it will display the type of each member, not just those that are ambiguous. When changing the membership of a list, it will print a message for each member added or deleted. +.IP \fB-noauth\ \fRor\ \fB-n\fR: +Do not attempt to perform Kerberos authentication with the Moira server. +Retrieval operations on not-hidden lists are still possible without +tickets. +.IP \fB-server\ \fIhost:port\ \fRor\ \fB-S\ \fIhost:port\fR: +Use the specified host and port to contact the Moira server instead of +the default server. Both may be symbolic names or numbers. If the +port is left off, the default Moira server port will be assumed. The +server chosen will be the one specified on the command line, specified +in the MOIRASERVER environment variable, the hesiod "moira" sloc entry, +or the compiled in default, in that order or preference. .IP \fB-debug\ \fRor\ \fB-D\fR: Turn on debugging messages.