# XML Security Library: Reporting Bugs and Getting Help

The best way to report a bug is to use the [XMLSec GitHub Issues Tracker](https://github.com/lsh123/xmlsec/issues)
or if you have a question -- [XMLSec GitHub Discussions](https://github.com/lsh123/xmlsec/discussions).

Before writing bug reports or questions, do not hesitate to check the [FAQ](faq.md).
If you are writing your own code based on the XML Security Library, then you should
try to reproduce your problem with the [xmlsec command-line utility](xmlsec-man.md)
first. And if it works just fine then you know whom to blame, don't you? :)

If you completed all the steps above and still think that you found something
new, please provide as much information as possible.
A good question or bug report **MUST** include the following:

- XML Security Library version number (or the snapshot date).
- The platform/compiler you are using.
- The exact xmlsec utility command line.
- All the files mentioned in this command line.
- The xmlsec utility output.

I'll do my best to fix reported bugs or answer questions as soon as I can.
And of course, any patches, bug fixes and improvements are always welcome!

Please note that the bug-tracking database is open to everyone.
Any private or confidential information posted there becomes public.
The authors of the XML Security Library assumes no responsibility for any damage caused
by any information distributed using the XMLSec GitHub issues tracker, discussions,
source code, or any other XMLSec-related tools.
