blender/tools
Campbell Barton ddf881ad9b Tools: add addr2line_backtrace to extract back-trace info on Unix/Linux
Since hiding symbols on Linux, in many cases only addresses are printed.
This utility can run run on the back-trace to replace addresses
with line & function information.

See: ./tools/utils/addr2line_backtrace.py --help for usage information.

Note that some examples online run addr2line directly and use the output
in the stack-trace, while convenient and acceptable in some cases, in my
tests addr2line can take over 20 seconds to complete for a single
address. Implement this as a post-process instead. Multi-processing to
prevent this taking too long (around ~23 seconds on my system).

Ref !111416.
2023-09-06 22:07:07 +10:00
..
check_blender_release Cleanup: spelling in comments, update dictionary 2023-09-03 21:35:07 +10:00
check_source Cleanup: spelling in comments 2023-09-05 11:04:27 +10:00
check_wiki License Headers: Set copyright to "Blender Authors", add AUTHORS 2023-08-16 00:20:26 +10:00
config Further tweaks to LSAN suppression rules. 2023-08-21 14:07:16 +02:00
git License Headers: Set copyright to "Blender Authors", add AUTHORS 2023-08-16 00:20:26 +10:00
modules License Headers: Set copyright to "Blender Authors", add AUTHORS 2023-08-16 00:20:26 +10:00
svn_rev_map License Headers: Set copyright to "Blender Authors", add AUTHORS 2023-08-16 00:20:26 +10:00
triage Cleanup: spelling in comments 2023-09-05 11:04:27 +10:00
utils Tools: add addr2line_backtrace to extract back-trace info on Unix/Linux 2023-09-06 22:07:07 +10:00
utils_api Cleanup: spelling in comments 2023-09-05 11:04:27 +10:00
utils_build Re-design of submodules used in blender.git 2023-02-21 16:39:58 +01:00
utils_doc License Headers: Set copyright to "Blender Authors", add AUTHORS 2023-08-16 00:20:26 +10:00
utils_ide/qtcreator Cleanup: spelling in comments 2023-09-05 11:04:27 +10:00
utils_maintenance Cleanup: Cover .metal files with make format 2023-09-05 09:59:47 +02:00
readme.rst Re-design of submodules used in blender.git 2023-02-21 16:39:58 +01:00

Blender Dev Tools
#################

This repository is intended for miscellaneous tools, utilities, configurations and
anything that helps with Blender development, but aren't directly related to building Blender.

Some of the tools included may be used stand-alone, others expect Blenders source code to be available.


Usage
=====

While this is a stand-alone repository,
some of the scripts which access Blenders source code assume this repository will be located at
``tools`` within Blenders source code repository. At some point this may be included as a submodule.

Some tools also rely on the ``blender`` binary, this is assumed to be located at: ``../../blender.bin``.
*The root directory of Blender's git repository*


Categories
==========

Check Source
------------

Any tools for scanning source files to report issues with code, style, conventions, deprecated features etc.


Config
------

Configuration for 3rd party applications (IDE's, code-analysis, debugging tools... etc).


Git
---

Scripts and utilities for working with git.


Utils
-----

Programs (scripts) to help with development
(currently for converting formats, creating mouse cursor, updating themes).