fstrm_replay(1)

πŸ’– fstrm_replay β€” the girlies' guide πŸ’–

okay so bestie, welcome to fstrm_replay from the General Commands Manual section (yes it's a section-1 command, main character energy only) ✨

🌸 NAME 🌸

fstrm_replay β€” replay your saved Frame Streams data straight into a socket connection. it's giving rerun the whole tape, but make it network πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

fstrm_replay -t content-type -r file [ -r file ... ]
     [ -u socket-path ] [ -a IP -p port ]

fstrm_replay --type content-type
     --read file [ --read file ... ]
     [ --unix socket-path ] [ --tcp IP --port port ]

short flags girlies and long flags girlies, both served, no cap 🫢


✨ DESCRIPTION ✨

so here's the vibe: fstrm_replay connects to a Frame Streams receiver β€” either on the socket-path you gave it as a UNIX domain socket, or on the TCP address and port you gave it β€” and then it reads data of the content-type you supplied, out of the file(s) you supplied, and sends it over 🌈

that's it. that's the whole plot. she reads, she sends, she slays πŸ’–


πŸ‘‘ OPTIONS πŸ‘‘

  • -t content-type, --type content-type β€” tell her the content-type to read from the files and send to the Frame Streams socket. files whose content-type differ are skipped β€” like, not invited to the party πŸ™ˆ. and if the socket server doesn't accept the content-type? fstrm_replay will fail. no cap, it just will πŸ’€
  • -r file, --read file β€” read data from file. you can stack multiple files by giving multiple -r options, go off πŸ‘‘. files which cannot be opened, or which don't contain valid Frame Streams data, will be skipped β€” she's not gonna fight them, she's just gonna move on 🧚
  • -u socket-path, --unix socket-path β€” connect to the UNIX domain socket-path to write Frame Streams data. ⚠️ only one of -u or -a may be given β€” pick a lane bestie, you cannot have both πŸ’…
  • -a IP, --tcp IP β€” connect to TCP address IP to write Frame Streams data. ⚠️ only one of -u or -a may be given, same rule, same energy. and using -a requires a port given with -p β€” she needs her little port bestie or she's not going anywhere πŸŽ€
  • -p port, --port port β€” if -a is given, use TCP port port to write Frame Streams data. that's the whole job. iconic, honestly 🌟

🌈 EXAMPLES 🌈

replay dnstap data over a UNIX domain socket, the classic:

fstrm_replay -t protobuf:dnstap.Dnstap \
     -u /var/run/named/dnstap.sock -r dnstap-log.fstrm

look at her go πŸ˜­πŸ’–


πŸŽ€ SEE ALSO πŸŽ€


and that's the whole page, bestie 🫢 this was fstrm_replay(1) from the General Commands Manual, version fstrm_replay(1) β€” go forth and replay, you've got this β­πŸ’œ