changelog: document incompatibility of viv files

`.viv` files (generated by vivisect) are not compatible between Python 2
and Python 3. This causes capa to raise an `UnicodeDecodeError`
exception and should be documented better. I'll add this change to the
release notes after the review.

Related to https://github.com/fireeye/capa/issues/469
This commit is contained in:
Ana Maria Martinez Gomez
2021-03-12 10:43:58 +01:00
parent 06c958f081
commit a31c616a21

View File

@@ -10,6 +10,15 @@ The capa explorer IDA plugin now helps you quickly build new capa rules using fe
![](doc/img/rulegen_expanded.png)
### Python 2/3 vivisect workspace compatibility
This version of capa adds Python 3 support in vivisect. Note that `.viv` files (generated by vivisect) are not compatible between Python 2 and Python 3. When updating to Python 3 you need to delete all the `.viv` files for capa to work.
If you get the following error (or a similar one), you most likely need to delete `.viv` files:
```
UnicodeDecodeError: 'ascii' codec can't decode byte 0x90 in position 2: ordinal not in range(128)
```
### Upcoming changes
**This is the last capa release that supports Python 2.** The next release will be v2.0 and will have breaking changes, including the removal of Python 2 support.