grommunio-admin-fetchmail(1)

📦 version 1.18, in alpine 3.24

🌸 grommunio-admin-fetchmail 🌸

okay bestie, so this is the grommunio-admin-fetchmail page from the grommunio-admin manual set — it's the little subcommand that handles everything fetchmail: showing entries, messing with entries, and generating that precious fetchmailrc file. pull up a chair, we're doing this 💖

✨ NAME ✨

grommunio-admin fetchmail — manage your fetchmail settings and generate the rc file. that's the whole vibe. 🎀

✨ SYNOPSIS ✨

grommunio-admin fetchmail create [<FIELDS>] --srcPassword PASSWORD
--srcServer SERVER --srcUser USER USERSPEC [MAILBOX]
grommunio-admin fetchmail delete [-y] MBSPEC
grommunio-admin fetchmail list [-f FILTER] [-s SORT] [MBSPEC]
grommunio-admin fetchmail modify [<FIELDS>] MBSPEC
grommunio-admin fetchmail print [-q] MBSPEC
grommunio-admin fetchmail show [--password] MBSPEC
grommunio-admin fetchmail write-rc [--force] [-o FILE] [-p] [-t MINUTES]
[-v]

like, pick your fighter, they're all here 💅

✨ DESCRIPTION ✨

so this is the subcommand that lets you see and manipulate fetchmail entries, and also generate the fetchmailrc file. lowkey essential, no cap. 🔥

✨ COMMANDS ✨

  • create — spin up a brand new fetchmail entry ✨
  • delete — yeet a fetchmail entry 🗑️
  • list — list out your fetchmail entries, we love a good list
  • modify — glow-up an existing fetchmail entry 💅
  • print — print the fetchmail configuration line that this entry generates
  • show — show the detailed deets about a fetchmail entry 🔍
  • write-rc — write the fetchmail configuration file (that's the fetchmailrc, iykyk) 🫶

✨ OPTIONS ✨

  • MAILBOX — the e-mail address of the local mailbox where the mails get delivered. defaults to the e-mail address of the user you specified 🍓
  • MBSPEC — mailbox prefix or the ID of the fetchmail entry
  • USERSPEC — username prefix or the ID of the user you want to attach the entry to
  • -f FIELD=<value>, --filter FIELD=<value> — a filter expression shaped like field=value. bestie you can pass this multiple times to refine the filter even more 🧚
  • --force — write the rc file even if literally no entries changed since the last write. it's giving "i said what i said" 😭
  • -o, --out-file — the path to write the configuration to. default is /etc/fetchmailrc
  • --password — print the source password 👀
  • -p, --print — additionally print the rc file to stdout
  • -q, --quiet — do not print extra info. shhh 🤫
  • -s FIELD, --sort FIELD — sort by field. can be given multiple times, stack 'em 🌈
  • -t, --time — time in minutes since the last write. by default it autodetects this from the file mtime ⏰
  • -v, --verbose — be more verbose, tell me everything 💬
  • -y, --yes — delete multiple entries without prompting. no take-backsies, so be sure fr fr 💀

✨ FIELDS ✨

  • --active STATE — whether the entry is active. STATE can be one of 0, 1, yes or no. default is 1 ✅
  • --extraOptions EXTRAOPTIONS — a space separated list of options to write into the fetchmailrc
  • --fetchall STATE — whether to fetch mails that are marked as seen on the source server. STATE can be one of 0, 1, yes or no. default is 0
  • --keep STATE — whether to keep the fetched mails on the source server. STATE can be one of 0, 1, yes or no. default is 1 💖
  • --protocol PROTOCOL — the protocol to use for fetching. can be one of POP3, IMAP, POP2, ETRN or AUTO. default is IMAP 👑
  • --srcAuth AUTH — the authentication method to use. can be one of password, kerberos_v5, kerberos, kerberos_v4, gssapi, cram-md5, otp, ntlm, msn, ssh, any. default is password 🔐
  • --srcFolder FOLDER — the source folder to fetch from
  • --srcPassword PASSWORD — the password of the source user. single (') and double (") quotes are automatically removed 🫣
  • --srcServer SERVER — the source server to fetch from
  • --srcUser USER — the source user to fetch mails from
  • --sslCertCheck STATE — whether to force the SSL certificate check. STATE can be one of 0, 1, yes or no. default is 0
  • --sslCertPath SSLCERTPATH — path to a directory containing trusted certificates, or empty to use the system default 🦋
  • --useSSL STATE — enable SSL ⭐

✨ SEE ALSO ✨

grommunio-admin(1), grommunio-admin-user(1) — go read your siblings' pages too, they're cute 🫶

and that's the whole page, bestie. every flag, every default, every state value — all accounted for, no facts lost, only vibes added 💅✨

mwah 💋 — this was grommunio-admin-fetchmail(1), from the grommunio-admin-fetchmail manual, signed off with love and a little sparkle 🎀💖

📦 where this page comes from