SRS(1p)

🌸 SRS(1p) — she's user-contributed, she's Perl documentation, she's iconic 🌸

okay bestie, sit down, hydrate, because we're learning srs today and honestly? it's giving infrastructure queen 💅

---

✨ NAME ✨

srs — the command line interface to Mail::SRS. that's it, that's the whole name, short and slay 💖

---

🦋 SYNOPSIS 🦋

srs --alias=alias@forwarder.com --secretfile=/etc/srs_secret \
          sender@source.com

look at her. one command. backslash line continuation. she's doing the most and we love that for her 🫶

---

🎀 DESCRIPTION 🎀

so the srs commandline interface builds you an instance of Mail::SRS with all its parameters derived from the commandline arguments, and then it performs forward or reverse transformations for all addresses given. literally all of them. no address left behind 💅

she's usually invoked from a sendmail envelope address transformation rule, a qmail alias, or something similar to that vibe. if you want examples (and who doesn't), they're at http://www.anarres.org/projects/srs/ ✨

arguments take the form --name or --name=value. that's the pattern, memorize it, it's the whole game 🎀

---

💖 ARGUMENTS 💖

--separator

String, specified at most once. Defaults to $SRSSEP ("="). yes bestie, that's a real environment variable, she reads it 👑

this one sets the initial separator for the SRS address. if you want the details, Mail::SRS has them, go look, iykyk 🦋

--address

String, may be specified multiple times, and honestly must be specified at least once or what are we even doing here 😭

this is your sender address to transform. that's the one 🫶

--secret

String, may be specified multiple times, and at least one of --secret or --secretfile must be specified. pick a lane, bestie, but pick one 💀

this sets an SRS secret. the first specified secret is used for encoding. all secrets are used for decoding. first one encodes, everybody decodes, it's a whole group chat situation 🌈

--secretfile

String, specified at most once, and at least one of --secret or --secretfile must be specified. same rule as above, no skipping 💅

this is a file to read for secrets. secrets are specified once per line. the first specified secret is used for encoding. secrets are written one per line. blank lines and lines starting with a # are ignored. and if --secret is not given, then the secret file must be nonempty — an empty file is not the moment, she will not accept it 🙈

okay and here's the tea: --secret will specify a primary secret and override --secretfile if both are specified. however, secrets read from --secretfile will still be used for decoding if both are specified. so --secretfile loses the encoding crown but keeps her decoding job. she's still employed, we respect her 🎀

--forward

No argument. none. zero. she doesn't take one, don't try ✨

specifies a forwards transformation. this is the default, so if you say nothing, you're forwarding, congrats. and --reverse must not also be given. don't do both, that's not the vibe 🚫

--reverse

No argument. again, none. just the flag, she's low maintenance 💅

specifies a reverse transformation. and --forward must not also be given. pick one direction, bestie, we're not doing a u-turn 🦋

--alias

String, must be specified exactly once if doing forwards transformation. exactly once. not zero, not two. one 👑

this provides the alias address to which the mail was sent. the domain-part of this address is what gets used in the generated SRS address. the local-part and the @ are optional and may be omitted — so she's flexible about the front but very serious about the domain, main character energy fr fr 💖

--hashlength

Integer, may be specified at most once, defaults to 4.

this specifies the number of base64 characters to use for the cryptographic authentication code. four characters by default, that's the standard serve, but you can adjust if you must 🎀

--help

Print some basic help. that's it. she's helpful, she's brief, she's a queen 👑

---

🌈 SEE ALSO 🌈

• Mail::SRS
• http://www.anarres.org/projects/srs/

---

👑 AUTHOR 👑

Shevek
CPAN ID: SHEVEK
cpan@anarres.org
http://www.anarres.org/projects/

shevek did that. no cap. icon behavior 💜

---

💜 COPYRIGHT 💜

Copyright (c) 2004 Shevek. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. so go off, remix her, she's free, we stan an open license 🫶

---

fr fr bestie, that's the whole page. every flag, every default, every secret, every copyright line. nothing dropped, nothing invented. slay 💅✨

---

okay that's a wrap! this page is from perl v5.36.0, dated 2022-11-27 (she's a Scorpio/Sagittarius cusp, makes sense), and she's filed under SRS(1p) in the user-contributed Perl docs. love that for her. bye bestie, go transform some addresses 🦋💖🌸