man/blanche.1

   1 .TH BLANCHE 1 "14 Sep 1988" "Project Athena"
   2 \" RCSID: $Header$
   3 .SH NAME
   4 blanche \- examine and modify memberships in SMS lists
   5 .SH SYNOPSIS
   6 .B blanche [options] listname [options]
   7 .SH DESCRIPTION
   8 .I Blanche
   9 is a tool for maintaining the membership of SMS lists.  It is more
  10 limited than the menu-oriented listmaint, but has a more traditional
  11 unix user interface which makes it easier to use in scripts.  It can
  12 also read a set of list members from a file and synchronize the list
  13 in SMS to that file.
  14
  15 Whenever a member is specified, it may be specified explicitly, as
  16 user:username, list:listname, or string:string_text; or the type may
  17 be left off if the member name is non ambiguous.  A member having
  18 punctuation characters (such as at-sign) in it is immediately assumed
  19 to be a string.  Otherwise,
  20 .B blanche
  21 will try first as a user, and if that fails will try the member as a
  22 list, and finally fall back to string if both of those fail.
  23
  24 The default output mode is similar, in that usernames are displayed
  25 without any identifying type, lists are always displayed as
  26 list:listname, and strings will only be labeled as a string if they do
  27 not have any punctuation characters in them.
  28 .SH OPTIONS
  29 .IP \fB-add\ \fImember\ \fRor\ \fB-a\ \fImember\fR:
  30 This will add the specified member to the target list.  This option
  31 may be specified multiple times with different members on the same
  32 command line.
  33 .IP \fB-delete\ \fImember\ \fRor\ \fB-d\ \fImember\fR:
  34 This will delete the specified member from the target list.  This
  35 option may be specified multiple times with different members on the
  36 same command line.
  37 .IP \fB-file\ \fIfilename\ \fRor\ \fB-f\ \fIfilename\fR:
  38 This will read a list of members from the named file, and make those
  39 members be the membership of the target list.  It will do this by
  40 extracting the current membership of the target list from SMS, then
  41 diff these two sets of members, and determine who has to be added and
  42 deleted from the list so it will match the contents of the file.
  43
  44 The file contains one member per line.  It may have blank lines.
  45 Anything following a semicolon is considered a comment.  If the
  46 .I filename
  47 is "-",
  48 .B blanche
  49 will read from standard input.
  50 .IP \fB-info\ \fRor\ \fB-i\fR:
  51 Display other information about the target list besides the
  52 membership.  This includes the description, flags, maillist and group
  53 status, owner, and last modification.
  54 .IP \fB-members\ \fRor\ \fB-m\fR:
  55 Display the membership of the target list.  This is the default if no
  56 other options are specified.
  57 .IP \fB-users\ \fRor\ \fB-u\fR:
  58 Only display list members that are users (not lists or strings).  If
  59 none of \fB-users, -lists, \fRor \fB-strings\fR is specified, then all
  60 of them will be displayed.
  61 .IP \fB-lists\ \fRor\ \fB-l\fR:
  62 Only display list members that are lists (not users or strings).  If
  63 none of \fB-users, -lists, \fRor \fB-strings\fR is specified, then all
  64 of them will be displayed.
  65 .IP \fB-strings\ \fRor\ \fB-s\fR:
  66 Only display list members that are strings (not users or lists).  If
  67 none of \fB-users, -lists, \fRor \fB-strings\fR is specified, then all
  68 of them will be displayed.
  69 .IP \fB-recursive\ \fRor\ \fB-r\fR:
  70 When displaying the membership of the target list, recursively track
  71 down all lists that are members of the target, and get their
  72 membership.  Only the user and string members will be displayed, not
  73 the intermediate lists.
  74 .IP \fB-verbose\ \fRor\ \fB-v\fR:
  75 Give more information.  With the info flag, it will also display the
  76 number of members on the list.  With the members flag, it will display
  77 the type of each member, not just those that are ambiguous.  When
  78 changing the membership of a list, it will print a message for each
  79 member added or deleted.
  80 .IP \fB-noauth\ \fRor\ \fB-n\fR:
  81 Do not attempt to perform Kerberos authentication with the SMS server.
  82 Retrieval operations on not-hidden lists are still possible without
  83 tickets.
  84 .IP \fB-debug\ \fRor\ \fB-D\fR:
  85 Turn on debugging messages.
  86
  87 .SH AUTHORS
  88 Mark Rosenstein and Jay Berkenbilt.
  89 .SH SEE ALSO
  90 listmaint(1)