.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, string:string_text, or
.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.
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.
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,
+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.
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 SMS server.
+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.
+.IP \fB-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR:
+Use the specified host and port to contact the Moira database 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
+database 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.
Mark Rosenstein and Jay Berkenbilt.
.SH SEE ALSO
listmaint(1)
+
+.SH NOTES
+The listname doesn't actually have to be the first argument, but if
+you put it anywhere else, it's easy to get the other arguments in the
+wrong order and do something other than what you intended.