LOGCONV.PL(1)

💖 LOGCONV.PL 💖

okay bestie, grab a boba because we're about to read your Directory Server's diary 🫶 this is logconv.pl, section 1 of the General Commands Manual, and she analyzes Directory Server access log files. periodt.

---

✨ NAME ✨

logconv.pl — analyzes Directory Server access log files

she's giving forensic investigator, she's giving nosy bestie reading your texts, she's giving data 💅

---

🌸 SYNOPSIS 🌸

logconv.pl [-h] [-d <rootDN>] [-s <size limit>] [-v] [-V] [-S <start
time>] [-E <end time>] [-T <min etime>] [-efcibaltnxgjuU] [ access log
... ... ]

look at her. so many little flags. so many little ways to learn the truth about your logs ✨

---

🦋 DESCRIPTION 🦋

she analyzes Directory Server access log files for specific information defined on the command line. that's it. that's the whole vibe. you tell her what you're curious about, she tells you. no cap. 🎀

---

💅 OPTIONS 💅

a summary of options is included below (and yes, we're doing all of them, we don't skip, skipping is not the vibe):

• -h, --help — help/usage. she'll explain herself, queen behavior 👑
• -d, --rootDN <Directory Managers DN> — the Directory Manager's DN. DEFAULT -> cn=directory manager
• -D, --data <Location for temporary data files> — where she puts her lil temporary data files. DEFAULT -> /tmp

TIP -> if you've got enough RAM, a RAM disk can be used instead: mkdir /dev/shm/logconv, and use this directory for the "-D" value. not her being efficient. we love a resourceful icon 💖

• -s, --sizeLimit <Number of results to return per category> — how many results she gives you per category. DEFAULT -> 20
• -X, --excludeIP <IP address to exclude from connection stats> — an IP address to exclude from connection stats. E.g. Load balancers. bye felicia, your LB is skewing the numbers 🙈
• -v, --version show version of tool — Print version of the tool. short and sweet, she knows who she is 💅
• -S, --startTime <time to begin analyzing logfile from> — Time to begin analyzing logfile from. E.g. [28/Mar/2002:13:14:22 -0800]
• -E, --endTime <time to stop analyzing logfile> — Time to stop analyzing logfile from. E.g. [28/Mar/2002:13:24:62 -0800]
• -T, --minEtime <minimum etime to report unindexed searches> — The minimum etime that is required to record and report on an unindexed search. Default is zero.
• -M, --reportFileMins <CSV output file> — This option creates a CSV report for spreadsheets. spreadsheet girlies rise up 🍓
• -m, --reportFileSecs <CSV output file> — This option creates a CSV report for spreadsheets. (yes, lowercase -m. she has two modes and they are both spreadsheet.)
• -B, --bind <ALL | ANONYMOUS | Bind DN > — This generates a report based on either ALL bind dn's, anonymous binds, or a specific DN.
• -V, --verbose <enable verbose output - includes all stats listed below except U> — Verbose output. everything, the whole menu, except U. main character energy 🌈
• -[efcibaltnxgjuU] — the little letters. the alphabet soup. the best part. here's every single one, no skipping, i said what i said:
  • e — Error Code stats
  • f — Failed Login Stats
  • c — Connection Code Stats
  • i — Client Stats
  • b — Bind Stats
  • a — Search Base Stats
  • l — Search Filter Stats
  • t — Etime Stats
  • n — Nentries Stats
  • x — Extended Operations
  • r — Most Requested Attribute Stats
  • g — Abandoned Operation Stats
  • j — Recommendations
  • u — Unindexed Search Stats (very detailed)
  • y — Connection Latency Stats
  • p — Open Connection ID Stats
  • U — Unindexed Search Summary

ngl bestie, u is very detailed. like, she will not be brief. hydrate before you run it 😭

---

🌈 USAGE 🌈

Examples (copy them exactly, they're sacred):

logconv.pl -s 10 -V access

logconv.pl -d "cn=directory manager"
/var/log/dirsrv/slapd-host/access*

logconv.pl -s 50 -ibgju access*

logconv.pl -S "[28/Mar/2002:13:14:22 -0800]" -E
"[28/Mar/2002:13:50:05 -0800]" -e access

see how she just works? iconic behavior honestly 🎀

---

👑 AUTHOR 👑

logconv.pl was written by the 389 Project. ty for your service, legends 🫶

---

🔥 REPORTING BUGS 🔥

Report bugs to https://github.com/389ds/389-ds-base/issues/new

if she's acting up, tell the devs. constructive feedback only, we're not mean here 💜

---

💜 COPYRIGHT 💜

Copyright © 2001 Sun Microsystems, Inc. Used by permission.

Copyright © 2017 Red Hat, Inc.

This manual page was written by Michele Baldessari <michele@pupazzo.org>, for the Debian project (but may be used by others).

This is free software. You may redistribute copies of it under the terms of the Directory Server license found in the LICENSE file of this software distribution. This license is essentially the GNU General Public License version 2 with an exception for plug-in distribution.

---

and that's the whole page bestie, no crumbs left ✨ this version is from the March 31, 2017 era of LOGCONV.PL(1), and yeah — this one's from General Commands Manual territory. go read your logs, they're literally telling you a story and she's the translator 🌸💖🦋