OS Manuals

/usr/bin/ovs-bugtool

Open vSwitch diagnostic data collection tool (ovs-bugtool) and its plugin descriptors and helper scripts

From ovs-3.5-bugtool 3.5.4-r11 (enterprise-packages), captured 2026-11-08 by running ovs-bugtool --help (exit 0). permalink

/usr/bin/ovs-bugtool: create status report bundles to assist in problem diagnosis
usage: /usr/bin/ovs-bugtool OPTIONS

By default, /usr/bin/ovs-bugtool prompts for permission to collect each form of status
information and produces a .tar.gz file as output.

The following options are available.
  --help                     display this help message, then exit
  -s, --silent               suppress most output to stdout

Options for categories of data to collect:
  --entries=CAP_A,CAP_B,...  set categories of data to collect
  --all                      collect all categories
  --ovs                      collect only directly OVS-related info
  --log-days=DAYS            collect DAYS worth of old logs
  --delay=DELAY              set delay between repeated command
  -y, --yestoall             suppress prompts to confirm collection
  --capabilities             print categories as XML on stdout, then exit

Output options:
  --output=FORMAT            set output format to one of tar tar.bz2 tar.gz zip
  --outfile=FILE             write output to FILE
  --outfd=FD                 write output to FD (requires --output=tar)
  --unlimited                ignore default limits on sizes of data collected
  --debug                    print ovs-bugtool debug info on stdout
Options (14)
OptionDescriptionSource
--helpPrint a summary of ovs-bugtool usage to stdout, then exit.help + man
-s, --silentSuppress most output to stdout.help + man + man
--entries CAP_ACollect the capabilities specified in the comma-separated list.help + man
--allCollect all available capabilities.help + man
--ovsIn addition to Open vSwitch configuration and status, ovs-bugtool can collect a variety of relevant system information.help + man
--log-days DAYSInclude the logs with last modification time in the previous days days in the debug bundle.help + man
--delay DELAYset delay between repeated commandhelp
-y, --yestoallsuppress prompts to confirm collectionhelp + man + man
--capabilitiesWrites the categories that ovs-bugtool can collect on stdout in XML, then exits.help + man
--output FORMATGenerates a debug bundle with the specified file type.help + man
--outfile FILEWrite output to file.help + man
--outfd FDwrite output to FD (requires --output=tar)help + man
--unlimitedignore default limits on sizes of data collectedhelp + man
--debugprint ovs-bugtool debug info on stdouthelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.