tracy-capture(1)

📦 version 0.11.0, in ubuntu questing

💖 tracy-capture(1) — the tracy-capture user manual, bestie edition 💖

okay so listen. this is tracy-capture, and it's the little app that saves the traces your tracy client is producing into a file. that's the whole vibe. it catches the trace and puts it somewhere safe. slay.

✨ NAME ✨

tracy-capture — a capture application that saves traces produced by a tracy client to a file. 🎀

🌸 SYNOPSIS 🌸

tracy-capture -o file [-a address] [-p port] [-f] [-s seconds]

like, that's it. that's the whole thing. short. iconic. periodt.

💅 OPTIONS 💅

  • -o file — the name of the file you want the trace written into. this one is required, bestie, there's no skipping it. no file, no trace, no nothing. 🫶
  • -a address — tells it the IP address of the client application. if you don't give one it just uses localhost. and ngl this part is kind of patient-girlfriend energy: if no client is running at that address, the server will just wait until it can make a connection. it's not gonna crash out, it's gonna sit there. 🧚
  • -p port — the network port that should be used. optional, you don't have to say it. ✨
  • -f — force overwrite, if the output file already exists. it's giving "yes i'm sure, i don't care what's in there, i'm replacing it". 💀
  • -s seconds — how many seconds to capture before it automatically disconnects. optional. it's the lil timer, the "okay that's enough, wrap it up" button. ⏰

🌈 DESCRIPTION 🌈

so while it's capturing, the utility is gonna show you stuff. like this, literally exactly like this:

% ./capture -a 127.0.0.1 -o trace
Connecting to 127.0.0.1:8086...
Queue delay: 5 ns
Timer resolution: 3 ns
1.33 Mbps / 40.4% = 3.29 Mbps | Net: 64.42 MB | Mem: 283.03 MB | Time: 10.6 s

now let me break down what you're looking at, because it's a lot of numbers and we're gonna read them together. 💖

the Queue delay and Timer resolution parameters are calibration results of the timers used by the client. so that's the client's timers getting measured up, not yours. 🎀

and then that last line? that's the status bar and she is doing the most. here's everything she's showing you:

  • network connection speed
  • connection compression ratio
  • the resulting uncompressed data rate
  • the total amount of data transferred over the network
  • memory usage of the capture utility
  • time extent of the captured data

obsessed honestly. six things in one line, main character energy fr fr. 👑

okay so to disconnect from the client AND save the captured trace, you press Ctrl + C. that's the move. that's how you get your file. don't panic, that's just how you finish. 😭

🦋 AUTHORS 🦋

maintained by Bartosz Taudul <wolf@nereid.pl>. and if you wanna know more about the upstream project, it lives at <https://github.com/wolfpld/tracy/>. go look, it's cute over there. 💜

this man page was written for the Debian GNU/Linux system by Alan M Varghese <alan@digistorm.in>. thank you alan, king behavior. 🙈

and that's the page!! go capture something gorgeous bestie, you got this. ✨ tracy-capture(1) — Debian GNU/Linux, section 1 of the manual, and yeah it's the tracy-capture User Manual. bye bye, love u, drink water 🍓💖🎀

📦 where this page comes from