IPPL(8)

📦
version 1.4.14 · 2 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

💖 IPPL(8) — the ippl girlies' manual 💖

System Manager's Manual ✨ okay bestie, sit down, we're learning about ippl 🎀

🌸 NAME 🌸

ippl — the IP Protocols Logger 👑 no cap.

🦋 SYNOPSIS 🦋

ippl [-hn] [-c file-name] [--help] [--nodaemon] [--config file-name]

that's it, that's the whole vibe check 💅

💜 DESCRIPTION 💜

okay so ippl is literally an IP protocols logger, periodt. it logs incoming TCP connections, UDP datagrams and ICMP packets sent to a host. she's watching 👀✨

ippl is based on the well-known iplogger written by Mike Edulla 🫶. The main drawback of iplogger is that it is not (easily) configurable 😭. ippl has been written keeping in mind that it should be extremely configurable and it should be easy to extend its logging capabilities. main character energy fr fr 💅🔥

✨ OPTIONS ✨

  • -c file-name, --config file-name — file-name specifies an alternate configuration file to use. By default, CONFIGURATION_FILE is used. so if you want a different config, this is your girl 💖
  • -h, --help — Print a usage message on standard output and exits successfully. iconic, helpful, no notes 🎀
  • -n, --nodaemon — This option cause ippl not to place itself in the background. The log messages will be logged to standard output instead of using syslog. lowkey so handy for debugging ngl 🦋

🌈 SIGNALS 🌈

ippl reacts to certain signal. An easy way to send it signals is to use the following command:

kill -SIGNAL `cat PID_FILE`
  • SIGHUP — This causes ippl to close all the open sockets and log files, reread the configuration file and restart 🔄. Note that this signal should be sent to ippl if the log files are renamed or deleted. (yes bestie, renamed OR deleted, keep that in mind 🙈)
  • SIGTERM — ippl will cleanly die 🕊️
  • SIGINT — If ippl has been started with th -n option, it will cleanly die 🕊️

🍓 FILES 🍓

  • /etc/ippl.conf — configuration file
  • /usr/share/doc/ippl/* — files worth reading if you still have a question 📚
  • /run/ippl/ippl.pid — file containing the PID of the running ippl 👑

💀 SEE ALSO 💀

ippl.conf(5), RFC768, RFC791, RFC792, RFC793, RFC1413

iykyk ✨

👑 AUTHORS 👑

Hugo Haas (hugo@larve.net) Etienne Bernard (eb@via.ecp.fr) 🫶

Information about ippl development can be found at http://larve.net/ippl/. 🌐

New stable releases can be dowloaded via FTP on sunsite.unc.edu in /pub/Linux/system/network/daemons. 📦✨

💌 MAILING LISTS 💌

Two mailing lists have been setup. Send an email to listar@via.ecp.fr to subscribe to the announcement list (ippl-announce) or to the development list (ippl). come join the group chat bestie 🎀💖

😭 BUGS 😭

  • If ippl spends too much time resolving host names, some packets may not be logged. 💀
  • The logclosing option logs TCP connection terminations. However, it logs terminations initiated by both ends, which is not the expected behavior. not the vibe we wanted 🙈
  • Please reports any bug to ippl@via.ecp.fr 📧

Last change: 21 April 2000 🌸 and that's the IPPL(8) page, bestie — she's from the System Manager's Manual, she ate, and she left no crumbs 💅✨🎀🦋

📦 where this page comes from