CSAF-ROLIE(1p)

👑 CSAF-ROLIE 👑

okay bestie, gather round, because this one is so good. this is the manual page for csaf-rolie, and it lives in the User Contributed Perl Documentation section of the manual (that's the 1p vibe, iykyk). she builds ROLIE feeds. she's iconic. let's go 💅

---

✨ NAME ✨

csaf-rolie — build a ROLIE (Resource-Oriented Lightweight Information Exchange) feed. periodt. 🎀

---

🌸 SYNOPSIS 🌸

csaf-rolie --csaf DIRECTORY [--tlp-label STRING|--feed-id STRING|--feed-title STRING|--base-url URL|--output PATH]
csaf-rolie [--help|--man|-v]

Options:
  -c, --conf PATH     YAML config path
  -d, --csaf DIR      CSAF documents directory
      --output PATH   Feed output file path (default {csaf}/{feed-id}.json)
      --tlp-label     TLP (Traffic Light Protocol) label (default "WHITE")
      --base-url      Feed base URL (default "https://psirt.domain.tld/advisories/csaf")
      --feed-id       Feed ID (default "csaf-feed-tlp-{tlp-label}")
      --feed-title    Feed title (default "CSAF feed (TLP:{tlp-label})")
      --stdout        Write ROLIE feed in STDOUT
      --verbose       Print verbose messages
      --test          Test the configuration and exit
      --help          Brief help message
      --man           Full documentation
  -v, --version       Print version

and here's the same energy, one bullet at a time, so your brain can actually hold it 💖

• -c, --conf PATH — the path to your YAML config, bestie 📄
• -d, --csaf DIR — the directory where your CSAF documents live 📁
• --output PATH — where the feed file gets written (default is {csaf}/{feed-id}.json) ✨
• --tlp-label — the TLP (Traffic Light Protocol) label (default "WHITE") 🚦
• --base-url — the feed's base URL (default "https://psirt.domain.tld/advisories/csaf") 🔗
• --feed-id — the feed ID (default "csaf-feed-tlp-{tlp-label}") 🆔
• --feed-title — the feed title (default "CSAF feed (TLP:{tlp-label})") 🏷️
• --stdout — writes the ROLIE feed straight to STDOUT 🖨️
• --verbose — prints verbose messages so you can watch the whole thing happen 🗣️
• --test — tests the configuration and then dips out 🧪
• --help — a brief help message, for when you just need a lil hint 🙈
• --man — the full documentation, aka the whole lore 📖
• -v, --version — prints the version ⭐

---

🦋 DESCRIPTION 🦋

so, csaf-rolie builds a ROLIE (Resource-Oriented Lightweight Information Exchange) feed using your CSAF documents. that's the whole job. she eats CSAF docs and serves a feed 🍓

https://docs.oasis-open.org/csaf/csaf/v2.0/os/csaf-v2.0-os.html

the Resource Oriented Lightweight Information Exchange (ROLIE for short, bestie) is a standard (RFC-8322) for exchanging security automation information between two machines, or between a machine and a human operator. machine to machine, machine to human, no cap 🤝

https://tools.ietf.org/html/rfc8322

---

💜 EXAMPLES 💜

🧚 Create a new ROLIE feed

$ csaf-rolie --csaf /var/www/html/advisories/csaf \
             --base-url https://security.acme.tld/advisories/csaf \
             --feed-title "ACME CSAF feed (TLP:WHITE)" \
             --verbose

CSAF directory : /var/www/html/advisories/csaf
TLP label      : WHITE
Base URL       : https://security.acme.tld/advisories/csaf
Feed ID        : csaf-feed-tlp-white
Feed title     : CSAF feed (TLP:WHITE)
Feed filename  : csaf-feed-tlp-white.json
Output file    : /var/www/html/advisories/csaf/csaf-feed-tlp-white.json

[*] Add ACMESA-2024:0001 in ROLIE feed
[*] Add ACMESA-2024:1337 in ROLIE feed

[...]

ROLIE feed saved in /var/www/html/advisories/csaf/csaf-feed-tlp-white.json

look at her go 😭 the little [*] Add ... lines are lowkey my favorite part. she's adding advisories one by one and telling you about it. main character energy fr fr 💅

🎀 Create a new ROLIE feed using a config file

available config items, so you know exactly what you're working with:

• csaf — CSAF documents directory
• output — Feed output file path (default {csaf}/{feed-id}.json)
• tlp-label — TLP (Traffic Light Protocol) label (default "WHITE")
• base-url — Feed base URL (default "https://psirt.domain.tld/advisories/csaf")
• feed-id — Feed ID (default "csaf-feed-tlp-{tlp-label}")
• feed-title — Feed title (default "CSAF feed (TLP:{tlp-label})")

ROLIE config file (rolie.conf) looking like this:

---
csaf: /var/www/html/advisories/csaf
base_url: https://security.acme.tld/advisories/csaf
tlp_label: WHITE
feed_id: acme-csaf-feed-tlp-white
feed_title: ACME CSAF feed (TLP:WHITE)

then use rolie.conf with the csaf-rolie command like so:

$ csaf-rolie --config /etc/csaf/rolie.conf

and if you wanna schedule the refresh of the ROLIE feed in crontab (set it and forget it era 🕐):

*/2 * * * * csaf-rolie --config /etc/csaf/rolie.conf 2> /dev/null

---

🌈 SEE ALSO 🌈

• csaf-validator — her bestie 🫶

---

⭐ AUTHOR ⭐

Giuseppe Di Terlizzi https://metacpan.org/author/gdt — the icon, the legend 👑

---

💖 COPYRIGHT AND LICENSE 💖

Copyright © 2023-2025 Giuseppe Di Terlizzi https://metacpan.org/author/gdt

you may use and distribute this module according to the same terms that Perl is distributed under. so, like, the Perl terms. no need to reinvent the license bestie, it's already cute 📜

---

and that's the whole page, angel 🦋

this was perl v5.40.1, dated 2025-09-03 — CSAF-ROLIE(1p), signing off 💅✨ mwah, go build a feed 🎀