oggz-validate(1)

πŸ’– oggz-validate β€” the vibe check for your Ogg files πŸ’–

okay so bestie, you know how a General Commands Manual page is like... the group chat of Unix docs? Well this one is oggz-validate(1) and it is literally the friend who reads your Ogg files and tells you if something's off. No cap. Let's get into it. πŸŽ€


✨ NAME ✨

oggz-validate β€” validate the Ogg framing of one or more files πŸ¦‹


✨ SYNOPSIS ✨

oggz-validate  [-M num  | --max-errors num ]  [-p  | --prefix ]  [-s  |
--suffix ]  [-P  | --partial ] filename ...

oggz-validate [-h  | --help ]  [-v  | --version ]

🌸 DESCRIPTION 🌸

oggz-validate validates the Ogg framing of one or more Ogg files. That's the whole assignment. It looks at the framing β€” not the codec, not the vibes of your audio, the framing β€” and it goes "hmm, girl, something's not right here." πŸ’…

Here's the thing though: oggz-validate detects the following errors in Ogg framing, and honestly the list is giving detective energy:

  • File contains no Ogg packets
  • Packets out of order
  • Packet belongs to unknown serialno
  • Granulepos decreasing within track
  • Multiple bos pages
  • Multiple eos pages
  • eos marked but no bos
  • Missing eos packets
  • eos marked on page with no completed packets
  • Granulepos on page with no completed packets
  • Theora video bos page after audio bos page
  • Terminal header page has non-zero granulepos
  • Terminal header page contains non-header packet
  • Terminal header page contains non-header segment

oggz-validate exits with status 0 if all files are valid Ogg files, and with status 1 if one or more errors are found. So 0 is the slay, 1 is the 😭. That's your whole exit status story, periodt.


✨ OPTIONS ✨

oggz-validate accepts the following options:

πŸ’… Error reporting options

  • -M num, --max-errors num β€” Exit after the specified number of errors. A value of 0 specifies no maximum. (so 0 means "keep going, I can take it" πŸ”₯)
  • -p, --prefix β€” Treat input as the prefix of a stream; suppress warnings about missing end-of-stream markers. She's not gone, she just hasn't finished yet πŸ₯Ί
  • -s, --suffix β€” Treat input as the suffix of a stream; suppress warnings about missing beginning-of-stream markers on the first chain. The beginning is somewhere else, bestie, don't panic 🫢
  • -P, --partial β€” Treat input as a the middle portion of a stream. Equivalent to both --prefix and --suffix. It's the middle child of flags and it contains multitudes 🌈

πŸŽ€ Miscellaneous options

  • -h, --help β€” Display usage information and exit.
  • -v, --version β€” Output version information and exit.

πŸ‘‘ AUTHOR πŸ‘‘

Conrad Parker April 3, 2005; β€” yes, the author line has a semicolon and we're keeping it exactly as-is because that's just the energy it has. Iconic. ✨


Copyright Β© 2005 CSIRO Australia


🌟 SEE ALSO 🌟


okay bestie that's the whole page, we ate and left no crumbs πŸ“ this was the oggz-validate(1) manual page from the General Commands Manual, dated April 3, 2005 β€” go forth and validate, fr fr. πŸ’–πŸ¦‹βœ¨