| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| majordomo_on_sdf [2022/08/25 02:45] – [Reading Archives] zilog | majordomo_on_sdf [2022/12/05 06:23] (current) – hc9 |
|---|
| ===== Interacting with majordomo-based Mail lists (mlists) on SDF ===== | ===== Interacting with Majordomo-based Mail lists (mlists) on SDF ===== |
| |
| ==== Intro ==== | ==== Intro ==== |
| |
| Since the early days of networked computing email has been used for group comunications which takes advantage of the ability to address an email message to multiple receipients. SDF hosts several email lists or mlists which are managed via //Majordomo//, an mlist manager. Unlike more modern mlist managers which generally have a web interface, //Majordomo// interaction is via short commands sent via email to ''majordomo@sdf.org'' (the domain may be left off when logged into SDF shell session). These commands and more are documented in the ''majordomo(8)'' manpage (type ''man majordomo'' to view within your SDF shell session). A condensed help offering is also available via the 'help' commands sent directly to //Majordomo//. | Since the early days of networked computing email has been used for group comunications which takes advantage of its ability to address a message to multiple recipients. SDF hosts several email lists or "mlists" which are managed via //Majordomo//, a mlist manager. Unlike more modern mlist managers which generally have a web interface, //Majordomo// interaction is via short commands sent via email to a mail alias generally of the same name. On SDF //Majordomo// commands are sent to ''majordomo@sdf.org'' (the domain may be left off when logged into SDF shell session). These commands and more are documented in the ''majordomo(8)'' manpage (type '//man majordomo//' to view within your SDF shell session). A condensed help offering is also available via the 'help' command sent directly to //Majordomo//. |
| |
| ==== Mail list Basics ==== | ==== SDF Mlist 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: | 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: |
| |
| <code> | <code> |
| | # get the majordomo help documentation: |
| | $ echo 'help' | mail -s 'Majordomo help' majordomo@sdf.org |
| | |
| # get a list of SDF hosted email lists: | # get a list of SDF hosted email lists: |
| $ echo 'list' > mail -s 'SDF mlists' majordomo@sdf.org | $ echo 'list' | mail -s 'list of SDF mlists' majordomo@sdf.org |
| | |
| | # get info on a specific SDF mlist: |
| | $ echo 'info XYZ' | mail -s 'Info on XYZ mlist' majordomo@sdf.org |
| | |
| # subcribe to a list: | # subcribe to a specific mlist: |
| $ echo 'subscribe XYZ' > mail -s 'Subscribe to XYZ' majordomo@sdf.org | $ echo 'subscribe XYZ' | mail -s 'Subscribe to XYZ' majordomo@sdf.org |
| |
| # unsubscribe to a list: | # unsubscribe to same mlist: |
| $ echo 'unsubscribe XYZ' > mail -s 'Unsubscribe to XYZ' majordomo@sdf.org | $ echo 'unsubscribe XYZ' | mail -s 'Unsubscribe to XYZ' majordomo@sdf.org |
| </code> | </code> |
| | |
| | Note that the //-s 'subject line'// entries shown above are strictly informational; //Majordomo// doesn't read them. |
| |
| 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: | 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> | <code> |
| # subscribing to list XYZ using some other email address: | # subscribing to list XYZ using some other email address: |
| $ echo 'subscribe XYZ me2@frog.bog' > mail -s 'Subscribe to XYZ' majordomo@sdf.org'' | $ echo 'subscribe XYZ me2@frog.bog' | mail -s 'Subscribe to XYZ' majordomo@sdf.org |
| </code> | </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. | For security purposes mlist subscription requests generally require an additional authorization string be sent back to ''majordomo@sdf.org'', similar to when setting up an online account on the Internet. You may also need to explicitly include your email address even if it's the one associated with your SDF account: |
| | |
| | <code> |
| | # example majordomo mlist confirmation: |
| | $ echo 'auth 5033d5d2027b51a2 subscribe XYZ sdf_usr@sdf.org' | mail -s 'confirm subscription' magordomo |
| | </code> |
| | |
| | If you ever need a reminder as to which -- if any -- SDF mlists you are currently subscribed to: |
| | |
| | <code> |
| | # show my SDF mlist subscriptions: |
| | $ echo 'which' | mail -s 'Current mlist subscriptions' majordomo@sdf.org |
| | </code> |
| ==== Reading the Mlist Archives ==== | ==== 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): | 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 public mlist archives are stored under the following directory on the SDF cluster (the main SDF hosts): |
| |
| <code> | <code> |
| </code> | </code> |
| | |
| Simple listings of the various mlist archives can be achieved using various Unix command pipes: | Simple listings of the various mlist archives can be achieved using common Unix command pipes: |
| |
| <code> | <code> |
| # show top-level SDF mlist listing: | # show top-level SDF mlist listing: |
| $ cd /sys/pkg6_amd64/share/majordomo/archives/ | $ cd /sys/pkg6_amd64/share/majordomo/archives/ |
| </code> | </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: | These archives are just MBox-formatted email files viewable directly via a pager like ''more(1)'' or ''less(1)'': |
| |
| <code> | <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]]. | 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: | There is also **mabro** , 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. **mabro** is located on the SDF cluster at ///sys/sdf/bin/mabro//. Basic usage is shown below: |
| |
| <code> | <code> |
| $ /sys/sdf/bin/mlists -h | $ /sys/sdf/bin/mabro -h |
| | |
| usage: mlists -h|-l|<keyword> | Mlist Archive BROwser for SDF public email list archives. |
| | |
| -h prints this helpful message | usage: mabro -h|-l|-t|<regex> |
| -l prints sorted listing of all archives | |
| <keyword> typical grep(1) compatible queries | -h prints this helpful message |
| ie. '^os' or '*ham*' | -l prints sorted listing of ALL archives |
| | -t top-level listing of all mlists |
| | <regex> grep(1) compatible queries, ie. '^anon' |
| |
| $ /sys/sdf/bin/mlists -t | $ /sys/sdf/bin/mabro -t |
| afitnuke-l guiche-list minecraft-l sdfarc-l | afitnuke-l guiche-list minecraft-l sdfarc-l |
| anonradio-l idahofreaks-l misbehavin sdfedu-l | anonradio-l idahofreaks-l misbehavin sdfedu-l |
| green-l lyct-l plan9-l vintage-l | green-l lyct-l plan9-l vintage-l |
| |
| $ /sys/sdf/bin/mlists radio | $ /sys/sdf/bin/mabro radio |
| SDF mlist archives matching "radio": | SDF mlist archives matching "radio": |
| |
| [07] anonradio-l.1601 [36] anonradio-l.1806 [65] anonradio-l.2011 | [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: | Enter item [#], do new [s]earch, [l]ist ALL mlists, or [q]uit: |
| </code> | </code> |
| |
| Once an archive is selected it opens in the ''mail(1)'' MUA for which only a handful of commands need to be used: | Once an archive is selected it opens in the //mail(1)// MUA for which only a handful of commands need to be used for basic message viewing: |
| | |
| * **//N//** -- display message number //N// | ^ mail cmd ^ description ^ |
| * **q** -- quits | | **//N//** | display message number //N// | |
| * **z** or **z-** -- page up/down message listing | | **+** / **-** | show next / previous message | |
| * **f <keyword>** -- search for thread containing //<keyword>// | | **h** | refresh message listing | |
| | | **x** | exit //mail// (returns to browser mode) | |
| | | **z** / **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. | Messages display using your PAGER (//more// is default); use arrow keys, page up/down, or spacebar to navigate or '**q**' to quit. |
| |
| ==== More Info ==== | **Note**: the archives are //read-only// and can't be modified so accidentally (or intentionally) deleting messages has no effect. |
| | ==== Additional Info ==== |
| |
| === References: === | === References: === |
| * majordomo v1 FAQ (mostly of interest to admins): [[http://manual.sdf.org/majordomo/FAQ]] | * Majordomo v1 FAQ (mostly of interest to admins): [[http://manual.sdf.org/majordomo/FAQ]] |
| * majordomo wikipedia page: [[https://en.wikipedia.org/wiki/Majordomo_(software)]] | * Majordomo wikipedia page: [[wp>Majordomo_(software)|Majordomo_(software)]] |
| * archive of GreatCircle.com/majordomo: [[https://web.archive.org/web/20120102123822/http://www.greatcircle.com/majordomo/]] | * archive of //GreatCircle.com/majordomo//: [[https://web.archive.org/web/20120102123822/http://www.greatcircle.com/majordomo/]] |
| |
| === Books covering Mojordomo: === | === Books covering Mojordomo: === |
| * //**Managing Mailing Lists: Majordomo, LISTSERV, Listproc, and SmartList**// by Alan Schwartz | * //Managing Mailing Lists: Majordomo, LISTSERV, Listproc, and SmartList// by Alan Schwartz |
| * //**Managing Internet Information Services**// by Cricket Liu & associates | * //Managing Internet Information Services// by Cricket Liu et.al. |
