clfsplit(1)

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

💖 clfsplit — bestie edition 💖

okay so this is clfsplit from the logtools squad, manual section 1 🎀 and it's literally the girl who takes your giant messy web logs and separates them by IP address. main character energy fr.

✨ SYNOPSIS ✨

clfsplit [--help] [-i input] -d defaultfile -f file -s spec [-f file -s spec]

yes bestie, you can stack -f file -s spec pairs as many times as your heart desires 💅

🌸 DESCRIPTION 🌸

so clfsplit splits up large CLF format web logs based on IP address. that's it, that's the job. it exists so you can make separate log analysis passes for internal and external users of web pages 🦋 no cap, that's the whole reason.

👑 OVERVIEW 👑

okay let's walk through it, stay with me 🫶

  • the defaultfile parameter says where data goes if it doesn't match any of the IP ranges. ngl, this could totally be /dev/null depending on your aims 💀 like if you literally do not care about the leftovers.
  • the -i input parameter gives the file to take input from — and the default is standard input ✨
  • the -f file parameter must be given before the list of IP addresses. it's giving "order matters, bestie" 🙈
  • the spec parameter is the IP addresses that go to the file in question 📁. it's of the form:
start[-end][:start[-end]]

where start and end specify the start and ends of ranges of IPs 🌈. also the CIDR notation can be used, or just a single IP address 💅. and if there's a large number of IP ranges then you can hand over a file name which contains a set of IP ranges, one range per line 📝 iconic.

💀 EXIT STATUS 💀

like, the vibe check at the end. here's what the numbers mean:

  • 0 — No errors 🎉 slay, we ate
  • 1 — Bad parameters 😭
  • 2 — Can't open input 🙈
  • 3 — Can't open/write to output file 💔
  • 4 — Can't open and read from spec file 🫠

🎀 AUTHOR 🎀

This program, its manual page, and the Debian package were written by Russell Coker <russell@coker.com.au> 🌸

🦋 SEE ALSO 🦋

k bye bestie, go split some logs 💜 this whole thing is by Russell Coker <russell@coker.com.au>, version 0.06, and it's a clfsplit(1) moment fr fr ✨💖🎀

📦 where this page comes from