void usage(const char *name, FILE *where)
{
fprintf (where, "Usage: %s [ options ] [ locations ]\n", name);
fprintf (where, "\nOutput options:\n");
fprintf (where, " -v --verbose Include additional details\n");
fprintf (where, " -s --silent Reduce the amount of details to show\n");
fprintf (where, " --ancestors Display the chain of ancestor objects up to the root\n");
fprintf (where, " --ancestor <type> Only display the ancestor of the given type\n");
fprintf (where, " -n Prefix each line with the index of the considered object\n");
fprintf (where, "Object filtering options:\n");
fprintf (where, " --restrict <cpuset> Restrict the topology to processors listed in <cpuset>\n");
fprintf (where, " --restrict binding Restrict the topology to the current process binding\n");
fprintf (where, " --no-io Do not show any I/O device or bridge\n");
fprintf (where, " --no-bridges Do not any I/O bridge except hostbridges\n");
fprintf (where, " --whole-io Show all I/O devices and bridges\n");
fprintf (where, "Input options:\n");
hwloc_utils_input_format_usage(where, 6);
fprintf (where, " --thissystem Assume that the input topology provides the topology\n"
" for the system on which we are running\n");
fprintf (where, " --pid <pid> Detect topology as seen by process <pid>\n");
fprintf (where, " --whole-system Do not consider administration limitations\n");
fprintf (where, " -l --logical Use logical object indexes for input (default)\n");
fprintf (where, " -p --physical Use physical object indexes for input\n");
fprintf (where, "Miscellaneous options:\n");
fprintf (where, " --version Report version and exit\n");
}
void usage(const char *name, FILE *where)
{
fprintf (where, "Usage: %s [ options ] ... [ filename.format ]\n\n", name);
fprintf (where, "See lstopo(1) for more details.\n");
fprintf (where, "\nDefault output is "
#ifdef LSTOPO_HAVE_GRAPHICS
#ifdef HWLOC_WIN_SYS
"graphical"
#elif (defined CAIRO_HAS_XLIB_SURFACE) && (defined HWLOC_HAVE_X11_KEYSYM)
"graphical (X11) if DISPLAY is set, console otherwise"
#else
"console"
#endif
#else
"console"
#endif
".\n");
fprintf (where, "Supported output file formats: console, ascii, fig"
#ifdef LSTOPO_HAVE_GRAPHICS
#ifdef CAIRO_HAS_PDF_SURFACE
", pdf"
#endif /* CAIRO_HAS_PDF_SURFACE */
#ifdef CAIRO_HAS_PS_SURFACE
", ps"
#endif /* CAIRO_HAS_PS_SURFACE */
#ifdef CAIRO_HAS_PNG_FUNCTIONS
", png"
#endif /* CAIRO_HAS_PNG_FUNCTIONS */
#ifdef CAIRO_HAS_SVG_SURFACE
", svg"
#endif /* CAIRO_HAS_SVG_SURFACE */
#endif /* LSTOPO_HAVE_GRAPHICS */
", xml, synthetic"
"\n");
fprintf (where, "\nFormatting options:\n");
fprintf (where, " -l --logical Display hwloc logical object indexes\n");
fprintf (where, " (default for console output)\n");
fprintf (where, " -p --physical Display physical object indexes\n");
fprintf (where, " (default for graphical output)\n");
fprintf (where, "Output options:\n");
fprintf (where, " --output-format <format>\n");
fprintf (where, " --of <format> Force the output to use the given format\n");
fprintf (where, " -f --force Overwrite the output file if it exists\n");
fprintf (where, "Textual output options:\n");
fprintf (where, " --only <type> Only show objects of the given type in the textual output\n");
fprintf (where, " -v --verbose Include additional details\n");
fprintf (where, " -s --silent Reduce the amount of details to show\n");
fprintf (where, " --distances Only show distance matrices\n");
fprintf (where, " -c --cpuset Show the cpuset of each object\n");
fprintf (where, " -C --cpuset-only Only show the cpuset of each object\n");
fprintf (where, " --taskset Show taskset-specific cpuset strings\n");
fprintf (where, "Object filtering options:\n");
fprintf (where, " --filter <type>:<knd> Filter objects of the given type, or all.\n");
fprintf (where, " <knd> may be `all' (keep all), `none' (remove all), `structure' or `basic'\n");
fprintf (where, " --ignore <type> Ignore objects of the given type\n");
fprintf (where, " --no-caches Do not show caches\n");
fprintf (where, " --no-useless-caches Do not show caches which do not have a hierarchical\n"
" impact\n");
fprintf (where, " --no-icaches Do not show instruction caches\n");
fprintf (where, " --merge Do not show levels that do not have a hierarchical\n"
" impact\n");
fprintf (where, " --no-collapse Do not collapse identical PCI devices\n");
fprintf (where, " --restrict <cpuset> Restrict the topology to processors listed in <cpuset>\n");
fprintf (where, " --restrict binding Restrict the topology to the current process binding\n");
fprintf (where, " --restrict-flags <n> Set the flags to be used during restrict\n");
fprintf (where, " --no-io Do not show any I/O device or bridge\n");
fprintf (where, " --no-bridges Do not any I/O bridge except hostbridges\n");
fprintf (where, " --whole-io Show all I/O devices and bridges\n");
fprintf (where, "Input options:\n");
hwloc_utils_input_format_usage(where, 6);
fprintf (where, " --thissystem Assume that the input topology provides the topology\n"
" for the system on which we are running\n");
fprintf (where, " --pid <pid> Detect topology as seen by process <pid>\n");
fprintf (where, " --whole-system Do not consider administration limitations\n");
fprintf (where, "Graphical output options:\n");
fprintf (where, " --children-order=plain\n"
" Display memory children below the parent like any other child\n");
fprintf (where, " --fontsize 10 Set size of text font\n");
fprintf (where, " --gridsize 10 Set size of margin between elements\n");
fprintf (where, " --horiz[=<type,...>] Horizontal graphical layout instead of nearly 4/3 ratio\n");
fprintf (where, " --vert[=<type,...>] Vertical graphical layout instead of nearly 4/3 ratio\n");
fprintf (where, " --rect[=<type,...>] Rectangular graphical layout with nearly 4/3 ratio\n");
fprintf (where, " --index=[<type,...>] Display indexes for the given object types\n");
fprintf (where, " --no-index=[<type,.>] Do not display indexes for the given object types\n");
fprintf (where, " --attrs=[<type,...>] Display attributes for the given object types\n");
fprintf (where, " --no-attrs=[<type,.>] Do not display attributes for the given object types\n");
fprintf (where, " --no-legend Remove the text legend at the bottom\n");
fprintf (where, " --append-legend <s> Append a new line of text at the bottom of the legend\n");
fprintf (where, "Miscellaneous options:\n");
fprintf (where, " --export-xml-flags <n>\n"
" Set flags during the XML topology export\n");
fprintf (where, " --export-synthetic-flags <n>\n"
" Set flags during the synthetic topology export\n");
fprintf (where, " --ps --top Display processes within the hierarchy\n");
fprintf (where, " --version Report version and exit\n");
}
void usage(const char *name, FILE *where)
{
fprintf (where, "Usage: %s [ options ] ... [ filename.format ]\n\n", name);
fprintf (where, "See lstopo(1) for more details.\n\n");
fprintf (where, "Supported output file formats: console, txt, fig"
#ifdef LSTOPO_HAVE_GRAPHICS
#if CAIRO_HAS_PDF_SURFACE
", pdf"
#endif /* CAIRO_HAS_PDF_SURFACE */
#if CAIRO_HAS_PS_SURFACE
", ps"
#endif /* CAIRO_HAS_PS_SURFACE */
#if CAIRO_HAS_PNG_FUNCTIONS
", png"
#endif /* CAIRO_HAS_PNG_FUNCTIONS */
#if CAIRO_HAS_SVG_SURFACE
", svg"
#endif /* CAIRO_HAS_SVG_SURFACE */
#endif /* LSTOPO_HAVE_GRAPHICS */
", xml, synthetic"
"\n");
fprintf (where, "\nFormatting options:\n");
fprintf (where, " -l --logical Display hwloc logical object indexes\n");
fprintf (where, " (default for console output)\n");
fprintf (where, " -p --physical Display physical object indexes\n");
fprintf (where, " (default for graphical output)\n");
fprintf (where, "Output options:\n");
fprintf (where, " --output-format <format>\n");
fprintf (where, " --of <format> Force the output to use the given format\n");
fprintf (where, " -f --force Overwrite the output file if it exists\n");
fprintf (where, "Textual output options:\n");
fprintf (where, " --only <type> Only show objects of the given type in the textual output\n");
fprintf (where, " -v --verbose Include additional details\n");
fprintf (where, " -s --silent Reduce the amount of details to show\n");
fprintf (where, " -c --cpuset Show the cpuset of each object\n");
fprintf (where, " -C --cpuset-only Only show the cpuset of each object\n");
fprintf (where, " --taskset Show taskset-specific cpuset strings\n");
fprintf (where, "Object filtering options:\n");
fprintf (where, " --ignore <type> Ignore objects of the given type\n");
fprintf (where, " --no-caches Do not show caches\n");
fprintf (where, " --no-useless-caches Do not show caches which do not have a hierarchical\n"
" impact\n");
fprintf (where, " --no-icaches Do not show instruction caches\n");
fprintf (where, " --merge Do not show levels that do not have a hierarchical\n"
" impact\n");
fprintf (where, " --restrict <cpuset> Restrict the topology to processors listed in <cpuset>\n");
fprintf (where, " --restrict binding Restrict the topology to the current process binding\n");
fprintf (where, " --no-io Do not show any I/O device or bridge\n");
fprintf (where, " --no-bridges Do not any I/O bridge except hostbridges\n");
fprintf (where, " --whole-io Show all I/O devices and bridges\n");
fprintf (where, "Input options:\n");
hwloc_utils_input_format_usage(where, 6);
fprintf (where, " --thissystem Assume that the input topology provides the topology\n"
" for the system on which we are running\n");
fprintf (where, " --pid <pid> Detect topology as seen by process <pid>\n");
fprintf (where, " --whole-system Do not consider administration limitations\n");
fprintf (where, "Graphical output options:\n");
fprintf (where, " --fontsize 10 Set size of text font\n");
fprintf (where, " --gridsize 10 Set size of margin between elements\n");
fprintf (where, " --horiz[=<type,...>] Horizontal graphical layout instead of nearly 4/3 ratio\n");
fprintf (where, " --vert[=<type,...>] Vertical graphical layout instead of nearly 4/3 ratio\n");
fprintf (where, " --no-legend Remove the text legend at the bottom\n");
fprintf (where, " --append-legend <s> Append a new line of text at the bottom of the legend\n");
fprintf (where, "Miscellaneous options:\n");
fprintf (where, " --ps --top Display processes within the hierarchy\n");
fprintf (where, " --version Report version and exit\n");
}
