GPROFNG-DISPLAY-HTML(1)

📦
version 2.47 · 15 versions
, in ubuntu stonking

💖 GPROFNG-DISPLAY-HTML 💖

okay bestie, so this is a page from the User Commands manual, the one and only gprofng-display-html — and no cap, she's the one who turns your profiles into a whole lil HTML website you can click around. 🦋

✨ NAME ✨

gprofng-display-html — generate an HTML based directory structure to browse the profiles. it's giving "your profile data, but make it a website." 💅

🎀 SYNOPSIS 🎀

gprofng display html [option(s)] experiment(s)

🌸 DESCRIPTION 🌸

So basically: you hand her one or more experiments and she processes them and generates a directory containing the index.html file, which you then use to browse the experiment data. main character energy fr fr. 👑

💜 OPTIONS 💜

  • --version — prints the version number and then dips. that's it, that's the whole job. ✨
  • --help — prints the usage information and exits. your bestie when you're lost. 🫶
  • --verbose — turns on verbose mode so you get diagnostic messages about what's happening while the data gets processed. by default verbose mode is disabled. flip it on if you want the tea. ☕
  • -d [db-vol-size], --debug[=db-vol-size] — controls the printing of run time debug information, to assist with the troubleshooting, or further development of this tool. 🔍

The db-vol-size parameter controls the output volume, and it's one from this list: s, S, m, M, l, L, xl, or XL. If db-vol-size is not set, a modest amount of information is printed — which is equivalent to selecting s, or S. The volume of data goes up as the size increases. lowkey important: currently l/L is equivalent to xl/XL, but this is expected to change in future updates. By default debug mode is disabled. 🙈

  • --highlight-percentage=value — set a percentage value in the interval [0,100] to select and color code source lines, as well as instructions, that are within this percentage of the maximum metric value(s). The default is 90 (%). A value of zero disables this feature. ✨ color coding?? we love to see it.
  • -o dirname, --output=dirname — use dirname as the directory name to store the results in. In absence of this option, the default name is display.<n>.html. This directory is created in the current directory. The number <n> is the first positive integer number not in use in this naming scheme. An existing directory with the same name is not overwritten — in case the directory exists already, an error message is printed and the tool terminates. 💀 so like, don't be messy.
  • -O dirname, --overwrite=dirname — use dirname as the directory name to store the results in. In absence of this option, the default name is display.<n>.html. This directory is created in the current directory. The number <n> is the first positive integer number not in use in this naming scheme. An existing directory with the same name is silently overwritten. 👀 yes bestie, silently. she's not gonna warn you.
  • -q, --quiet — disable the display of all warning, debug, verbose and any other messages. If enabled, the settings for verbose and debug are accepted, but ignored. With this option, there is no screen output, other than errors. By default quiet mode is disabled. 🤫 silence, but make it on purpose.
  • --nowarnings — disable the printing of warning messages on stdout. By default warning messages are printed. 🚫

🌈 NOTES 🌈

  • The options and values are case sensitive. (yes, really. s and S are not the same vibe check.) 🔥
  • In this release, the option syntax has changed to be more compliant with other tools and commands.

The options that used to have an on or off value only, now act as a switch. The option negates the default setting. For example, by default, verbose mode is disabled. It is enabled by using the --verbose option.

The long options, those starting with "--", that require a value, expect the "=" sign between the option and the value.

While the previous syntax and choices are accepted still, we strongly recommend to change the usage of the options according to the new syntax and values. At some point, these legacy settings may no longer be accepted. 😭

To assist with the transition, a warning message is shown if the legacy syntax, or value, or both, are used.

  • The -hp option is still accepted, but it will be deprecated in a future release. Use the --highlight-percentage option instead. 🎀
  • When setting a directory name for the HTML files to be stored in, make sure that umask is set to the correct access permissions. 🔐 bestie please check your permissions.
  • Regardless of the setting for the warning messages, if there are warnings, they are accessible through the main index.html page. 📄
  • The tool tries to accumulate as many warnings and errors as possible, before taking action. In this way, it is easier to address multiple issues at once. As a result of this approach, it may be that the messages do not show immediately. In particular, warnings are shown towards the end of the execution, but one or more errors will terminate execution before the processing begins. ⏳ so if you don't see anything yet — she's cooking.

🦋 SEE ALSO 🦋

gprofng(1), gprofng-archive(1), gprofng-collect-app(1), gprofng-display-src(1), gprofng-display-text(1)

The user guide for gprofng is maintained as a Texinfo manual. If the info and gprofng programs are correctly installed, the command info gprofng should give access to this document. 📚

Copyright (c) 2022-2026 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". ⭐

and that's the whole thing, bestie!! 🥳 this version of the page is from binutils-2.47, dated 2026-09-10, so if you're reading this from the future, check for a glow-up. 💖 bye ily, go browse those profiles ✨👑🫶

📦 where this page comes from