SINNTP(1)

📦 version 1.6, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 SINNTP(1) — the sinntp manual, bestie edition 💖

okay so you're looking at the manual page for sinntp (that's the sinntp manual, section 1, we love a numbered section 🎀) and honestly? you're gonna eat this up. let's go.

✨ NAME ✨

sinntp — a tiny non-interactive NNTP client. she's small, she's non-interactive, she's iconic. periodt. 👑

✨ SYNOPSIS ✨

sinntp command [options...] [args...]

that's it. that's the whole vibe. command first, then your options, then your args. simple, clean, main character energy. 💅

✨ DESCRIPTION ✨

so sinntp is a tiny NNTP client that was originally designed to work in non-interactive mode — meaning she does her thing without you sitting there chatting with her. lowkey the dream tbh. 🦋

here's what she can do for you:

  • sending articles to the server — push it, queen 💌
  • fetching new articles to the mbox file — bring the goods home 📥
  • downloading individual messages in RFC822 format — one (1) message, hand-delivered ✨
  • listing available newsgroups — the full menu, no cap 📋

✨ COMMANDS ✨

sinntp provides following commands:

  • get
  • list
  • pull
  • push

and here's the cute part: you can also invoke the above commands via convenience wrappers that follow the nntp-command scheme (so like, nntp-get). if you wanna know the synopsis and description for each of those, go check the wrappers' own manual pages, bestie — they have their own lore. 📖🫶

✨ GLOBAL OPTIONS ✨

these work everywhere, they're the universal slay:

  • --version — shows you the program's version number and then exits. short and sweet. 🎀
  • -h, --help — shows a short help message and exits. (yes, the original says "end exit" — we all know what she meant. 💀)
  • -v, --verbose — be more verbose. stack it multiple times to keep cranking the verbosity up. 🗣️
  • -q, --quiet — be less verbose. stack it multiple times to keep dialing the verbosity down. 🤫
  • -p, --plugin=plugin — load and use a plugin. plug it in, plug it in. 🔌
  • -S, --server=host, --server=host:port — connect to the specified host and port. if you omit this, sinntp will use the address stored in the /etc/nntp/server file or in the NNTPSERVER variable — and heads up, the latter takes precedence over the former. 🌐
  • -U, --username=username — use the specified username for authentication. 🪪
  • -P, --password=password — use the specified password for authentication.
use with caution! the password may be visible to other users of the system. not me telling you your secrets out loud in the group chat 😭🔒
  • --no-netrc — do not attempt to read authentication credentials (username, password) from the ~/.netrc file. leave that file alone fr fr. 🙈
  • -t, --timeout=timeout — wait a maximum of timeout seconds during communication with the server. patience has a limit, bestie. ⏳

also, a particular command can support additional options — so don't be shocked when a command has extras. 💫

✨ PLUGINS ✨

pulled and pushed messages can be altered by the plugin mechanism. currently the sinntp package includes following plugins:

  • mimify — add default charset to the message when it is not present. she gives your message a charset when it forgot to bring one 🧚
  • strip_headers — strip specified headers from message. bye bye headers, we don't need you ✂️

✨ ENVIRONMENT VARIABLES ✨

  • NNTPSERVER — address of the default NNTP server. it can be overridden by the --server option. 🖥️
  • XDG_DATA_HOME — location of the sinntp data directory. see the XDG Base Directory Specification[1] for details. 📁

✨ FILES ✨

  • /etc/news/server — a file with the NNTP server address. can be overridden by the NNTPSERVER environment variable or the --server option. 📄
  • $XDG_DATA_HOME/sinntp/ — location of sinntp data files. 🗂️

✨ SEE ALSO ✨

nntp-get(1), nntp-list(1), nntp-push(1), nntp-pull(1)

go read those too, they're the extended universe. 🌈

Copyright © 2009, 2010, 2011, 2012 Piotr Lewandowski, Jakub Wilk

✨ NOTES ✨

  1. XDG Base Directory Specification https://specifications.freedesktop.org/basedir-spec/latest/

and that's the whole page, bestie!! this was sinntp 1.6, dated 2016-12-19 — so yes she's an elder but she still slays, and honestly? she ate. 💜✨ go forth and non-interactively do your thing. mwah. 🫶🎀

📦 where this page comes from