Differences

This shows you the differences between two versions of the page.

--- majordomo_on_sdf [2022/08/25 01:08] – [Intro] zilog
+++ majordomo_on_sdf [2022/08/25 02:45] – [Reading Archives] zilog
@@ Line 6: / Line 6: @@
 ==== Mail list Basics ====
+Although there are several commands listed in the //Majordomo// documentation users only needs to know a few of them.  For simplicity the examples below make use of the native BSD ''mail(1)'' email client used within an SDF shell session:
-==== Reading Archives ====
+<code>
+# get a list of SDF hosted email lists:
+$ echo 'list' > mail -s 'SDF mlists' majordomo@sdf.org
+# subcribe to a list:
+$ echo 'subscribe XYZ' > mail -s 'Subscribe to XYZ' majordomo@sdf.org
+# unsubscribe to a list:
+$ echo 'unsubscribe XYZ' > mail -s 'Unsubscribe to XYZ' majordomo@sdf.org
+</code>
+If you wish to subscribe using an email address other than the one associated with your SDF account simply append it to the end of the command line:
+<code>
+# subscribing to list XYZ using some other email address:
+$ echo 'subscribe XYZ me2@frog.bog' > mail -s 'Subscribe to XYZ' majordomo@sdf.org''
+</code>
+For security mlist subscription requests generally require a one-time authorization be sent back to ''majordomo@sdf.org'', similar to when setting up an online account on the Internet.
+==== Reading the Mlist Archives ====
+While //Majordomo// supports digests and archive file requests it appears most SDF mlists don't offer these so the only option for reading archived messages is browsing them from within an SDF shell session.  The mlist archives are stored under the following directory on the SDF cluster (the main SDF hosts):
+<code>
+  /sys/pkg6_amd64/share/majordomo/archives/
+</code>
+Simple listings of the various mlist archives can be achieved using various Unix command pipes:
+<code>
+# show top-level SDF mlist listing:
+$ cd /sys/pkg6_amd64/share/majordomo/archives/
+$ ls -1 | sed 's/\..*$//' | sort -u | rs
+  afitnuke-l         guiche-list        minecraft-l        sdfarc-l
+  anonradio-l        idahofreaks-l      misbehavin         sdfedu-l
+  bts-loss           indaba-l           modeltheory-l      sealug-l
+  comp-l             insight-l          newguard-l         sras-l
+  cw-l               jax_joxe-l         osgroup-l          truthy-l
+  discuss-l          jh-l               partitions-list    twenex-l
+  educators-l        kaire-list         piziali_family     twosigma-l
+  fourquad-l         lycevents          piziali_lifegroup  uktour
+  green-l            lyct-l             plan9-l            vintage-l
+# list all archives of a particular mlist:
+  $ cd /sys/pkg6_amd64/share/majordomo/archives/
+  $ ls uktour* | rs
+  uktour.0209  uktour.0211  uktour.0502  uktour.0504  uktour.0507
+  uktour.0210  uktour.0212  uktour.0503  uktour.0505
+</code>
+These are all just MBox-formatted email files so you could just use a pager like ''more(1)'' or ''less(1)'' to read them directly:
+<code>
+# reading the uktour.0209 archive using more(1):
+$ more /sys/pkg6_amd64/share/majordomo/archives/uktour.0209
+</code>
+You can use ''/^Subject:''  within ''more(1)'' or ''less(1)'' to jump to the Subject line of each message; pressing ''**.**'' repeats the last command.
+Still, using an actual mail user agent (MUA) will probably improve the readability.  Below is an example using the previously illustrated native BSD ''mail(1)'' MUA:
+<code>
+# reading the uktour.0209 archive using mail(1):
+$ mail -f /sys/pkg6_amd64/share/majordomo/archives/uktour.0209
+</code>
+For guidance on using ''mail(1)'' see [[traditional_mail_1_mailx_1|An Introduction to Various BSD mailx style E-mail Clients on SDF]].
+There is also **mlists** , an SDF user-contributed SDF mlist archive browser -- just a shell script -- which uses the forementioned //mail// MUA to make browsing the mlist archives a bit easier. **mlists** is located on the SDF cluster at ///sys/sdf/bin/mlists//.  Basic usage is shown below:
+<code>
+$ /sys/sdf/bin/mlists -h
+ usage: mlists -h|-l|<keyword>
+      -h         prints this helpful message
+      -l         prints sorted listing of all archives
+      <keyword>  typical grep(1) compatible queries
+                 ie. '^os' or '*ham*'
+$ /sys/sdf/bin/mlists -t
+afitnuke-l         guiche-list        minecraft-l        sdfarc-l
+anonradio-l        idahofreaks-l      misbehavin         sdfedu-l
+bts-loss           indaba-l           modeltheory-l      sealug-l
+comp-l             insight-l          newguard-l         sras-l
+cw-l               jax_joxe-l         osgroup-l          truthy-l
+discuss-l          jh-l               partitions-list    twenex-l
+educators-l        kaire-list         piziali_family     twosigma-l
+fourquad-l         lycevents          piziali_lifegroup  uktour
+green-l            lyct-l             plan9-l            vintage-l
+$ /sys/sdf/bin/mlists radio
+SDF mlist archives matching "radio":
+ [01] anonradio-l.1507        [30] anonradio-l.1712        [59] anonradio-l.2005
+ [02] anonradio-l.1508        [31] anonradio-l.1801        [60] anonradio-l.2006
+ [03] anonradio-l.1509        [32] anonradio-l.1802        [61] anonradio-l.2007
+ [04] anonradio-l.1510        [33] anonradio-l.1803        [62] anonradio-l.2008
+ [05] anonradio-l.1511        [34] anonradio-l.1804        [63] anonradio-l.2009
+ [06] anonradio-l.1512        [35] anonradio-l.1805        [64] anonradio-l.2010
+ [07] anonradio-l.1601        [36] anonradio-l.1806        [65] anonradio-l.2011
+ ...
+        [s]     Enter new search term
+        [q]     Quit
+Enter item [#], do new [s]earch, [l]ist-all or [q]uit:
+</code>
+Once an archive is selected it opens in the ''mail(1)'' MUA for which only a handful of commands need to be used:
+  * **//N//**  -- display message number //N//
+  * **q**  -- quits
+  * **z** or **z-**  -- page up/down message listing
+  * **f <keyword>**  -- search for thread containing //<keyword>//
+Messages display using your PAGER (//more// is default); use arrow keys, page up/down, or spacebar to navigate or '**q**' to quit.
 ==== More Info ====