ethcapture(1)

✨ NAME ✨

ethcapture — bestie, this is the manual page for ethcapture, living in the EFSFFCLIRG manual set 💖

Okay so real talk: ethcapture captures critical system information into a zipped tar file. That resulting tar file should be sent to Intel Customer Support along with any Intel(R) Ethernet Fabric problem reports regarding this system. It's literally the "here's everything, help me" bundle 🫶

NOTE: the resulting host capture file can require significant amounts of space on the host. While the actual size varies, sizes can be multiple megabytes. Intel recommends ensuring that adequate disk space is available on the host system. So like… check your disk first, no cap 💀

🌸 SYNTAX 🌸

ethcapture [-d  detail]  output_tgz_file

🎀 OPTIONS 🎀

• --help — produces full help text. That's it, that's the whole vibe ✨
• -d detail — captures level of detail, and there are three whole flavors:
  1. 1 (Local) — obtains local information from host. This is the default if no options are entered. 🏠
  2. 2 (Fabric) — in addition to Local, obtains basic fabric information using ethreport. 🧵
  3. 3 (Analysis) — in addition to Fabric, obtains ethallanalysis results. If ethallanalysis has not yet been run, it is run as part of the capture. 🔍

NOTE: - Detail levels 2 - 3 can be used when fabric operational problems occur. If the problem is node-specific, detail level 1 should be sufficient. Detail levels 2 - 3 require an operational Fabric. Typically, your support representative requests a given detail level. If a given detail level takes excessively long or fails to be gathered, try a lower detail level. (yes bestie, downgrade the drama, it's fine 🙈) - For detail levels 2 - 3, the additional information is only available on a node with Intel(R) Ethernet Fabric Suite FastFabric Toolset installed. No toolset, no extra tea ☕

• output_tgz_file — specifies the name of a file to be created by ethcapture. The file name specified is overwritten if it already exists (!!! so be careful, it's giving no mercy). Intel recommends using the .tgz suffix in the file name supplied. If the filename given does not have a .tgz suffix, the .tgz suffix is added. It just adds it itself, main character energy 💅

🦋 EXAMPLES 🦋

ethcapture mycapture.tgz

ethcapture -d 3 030127capture.tgz

That's the whole page, periodt. 🌈 This one's from the EFSFFCLIRG man page collection, version vibes courtesy of Copyright(C) 2020-2024 Intel Corporation — and yes, the manual page name is ethcapture(1), iykyk 👑 💜