f9c4e25483
Provide fd_rd_output facilities which enable constructing RD dumps that are stored into gzip-compressed output. This matches the default behavior of libwrap. Enabling and adjusting the behavior of functionality is done through the FD_RD_DUMP environment variable. Integration into Turnip's MSM backend is covered, replacing the previous RD dump that was enabled through TU_DEBUG=rd. That debug option still works and is the same as using FD_RD_DUMP=enable. By default the dumps are created for each submission, using the provided submit index. FD_RD_DUMP=combine enables gathering dumps for submissions for the given logical device into a single file. In the Turnip integration, FD_RD_DUMP=full will force dumping contents of any buffer object. Additionally, with that option enabled any previous submit will be waited on. Specifying FD_RD_DUMP=trigger sets up a trigger file that can be used to activate dumping manually. Writing zero or some non-integer value to the file will disable dumping. Writing a positive integer value to it will enable dumps for that many future submissions. Writing -1 to it will enable dumps until disabled. Signed-off-by: Zan Dobersek <zdobersek@igalia.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/27230>
`Mesa <https://mesa3d.org>`_ - The 3D Graphics Library ====================================================== Source ------ This repository lives at https://gitlab.freedesktop.org/mesa/mesa. Other repositories are likely forks, and code found there is not supported. Build & install --------------- You can find more information in our documentation (`docs/install.rst <https://mesa3d.org/install.html>`_), but the recommended way is to use Meson (`docs/meson.rst <https://mesa3d.org/meson.html>`_): .. code-block:: sh $ mkdir build $ cd build $ meson .. $ sudo ninja install Support ------- Many Mesa devs hang on IRC; if you're not sure which channel is appropriate, you should ask your question on `OFTC's #dri-devel <irc://irc.oftc.net/dri-devel>`_, someone will redirect you if necessary. Remember that not everyone is in the same timezone as you, so it might take a while before someone qualified sees your question. To figure out who you're talking to, or which nick to ping for your question, check out `Who's Who on IRC <https://dri.freedesktop.org/wiki/WhosWho/>`_. The next best option is to ask your question in an email to the mailing lists: `mesa-dev\@lists.freedesktop.org <https://lists.freedesktop.org/mailman/listinfo/mesa-dev>`_ Bug reports ----------- If you think something isn't working properly, please file a bug report (`docs/bugs.rst <https://mesa3d.org/bugs.html>`_). Contributing ------------ Contributions are welcome, and step-by-step instructions can be found in our documentation (`docs/submittingpatches.rst <https://mesa3d.org/submittingpatches.html>`_). Note that Mesa uses gitlab for patches submission, review and discussions.