From 2d1d1fcdad4150c0d51d1a03e911bfd99ebbdae4 Mon Sep 17 00:00:00 2001 From: danw Date: Mon, 8 Sep 1997 19:51:00 +0000 Subject: [PATCH] document new features --- man/blanche.1 | 59 ++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 42 insertions(+), 17 deletions(-) diff --git a/man/blanche.1 b/man/blanche.1 index 51fc3874..18107e20 100644 --- a/man/blanche.1 +++ b/man/blanche.1 @@ -28,15 +28,15 @@ list:listname, and strings will only be labeled as a string if they do 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: +.IP \fB-add\ \fImember\ \fRor\ \fB-a\ \fImember\fR This will add the specified member to the target list. This option may be specified multiple times with different members on the same command line. -.IP \fB-delete\ \fImember\ \fRor\ \fB-d\ \fImember\fR: +.IP \fB-delete\ \fImember\ \fRor\ \fB-d\ \fImember\fR This will delete the specified member from the target list. This option may be specified multiple times with different members on the same command line. -.IP \fB-file\ \fIfilename\ \fRor\ \fB-f\ \fIfilename\fR: +.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 Moira, then @@ -49,60 +49,85 @@ Anything following a semicolon is considered a comment. If the is "-", .B blanche will read from standard input. -.IP \fB-info\ \fRor\ \fB-i\fR: +.IP \fB-info\ \fRor\ \fB-i\fR 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: +.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: +.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: +.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: +.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: +.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: +.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: +.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: +.IP \fB-recursive\ \fRor\ \fB-r\fR When displaying the membership of the target list, recursively track 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: +.IP \fB-verbose\ \fRor\ \fB-v\fR Give more information. With the info flag, it will also display the 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: +.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-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR: +.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. +.IP \fB-create\ \fRor\ \fB-C\fR +Create the named list (assuming you have list-creation priviliges in +Moira.) By default it will be active, private, visible, a mailing +list, and not a group, although this can be changed with the flags +below. +.IP \fB-rename\ \fInewname\ \fRor\ \fB-R\ \fInewname\fR +Rename the list to the new name. +.IP \fB-public\ \fR(\fB-P\fR)\ \fRor\ \fB-private\ \fR(\fB-NP\fR) +Make the list public or private. (Users can add themselves to public +lists.) +.IP \fB-active\ \fR(\fB-A\fR)\ \fRor\ \fB-inactive\ \fR(\fB-I\fR) +Make the list active or inactive. (Inactive lists are not propagated +to the mailhubs and fileservers.) +.IP \fB-visible\ \fR(\fB-V\fR)\ \fRor\ \fB-hidden\ \fR(\fB-H\fR) +Make the list visible or hidden. (Hidden lists are harder to find the +membership and admistrators of.) +.IP \fB-mail\ \fR(\fB-M\fR)\ \fRor\ \fB-notmail\ \fR(\fB-NM\fR) +Toggle whether or not the list is a mailing list. +.IP \fB-group\ \fR(\fB-G\fR)\ \fRor\ \fB-notgroup\ \fR(\fB-NG\fR) +Toggle whether or not the list is a group. (Groups can be used on the +ACLs of directories in AFS.) +.IP \fB-desc\ \fIdescription\ \fRor\ \fB-D\ \fIdescription\fR +Set the description of the list. +.IP \fB-owner\ \fIowner\ \fRor\ \fB-O\ \fIowner\fR +Set the owner of the list. The owner is specified like a list member, +except that list owners can never be strings. + .SH AUTHORS Mark Rosenstein and Jay Berkenbilt. -- 2.45.2