Skip to content

Releases: burrowers/garble

v0.14.0

26 Jan 21:42
v0.14.0
561158d
Compare
Choose a tag to compare

This release drops support for Go 1.22 and continues support for Go 1.23.

@lu4p improved the compatibility with reflection of Go types by collecting the set of all types used with reflection during the entire build, and then inject the de-obfuscation of their names in the link step. Thanks to this, many more Go packages should work out of the box, and the README caveat suggesting the use of "reflection hints" is removed.

@mvdan replaced our own tracking of type aliases, necessary given that the alias name becomes a field name when embedded into a struct type. We now rely entirely on upstream Go's tracking of aliases in go/types. Note that this means that Garble now requires Go 1.23.5 or later, given that alias tracking did not work properly in previous Go versions.

A number of fixes are also included:

  • Reduce the amount of info fetched from go list -json for a ~2% speed-up
  • Package names and paths are now obfuscated separately
  • Hashing of struct types to obfuscate field names is now better implemented
  • Fix a panic which could occur when using structs as type parameters

v0.13.0

05 Sep 20:22
v0.13.0
85df7f5
Compare
Choose a tag to compare

This release drops support for Go 1.21 and adds support for Go 1.23.

A number of fixes are also included:

  • Fix obfuscation errors when arch-dependent struct padding is used
  • Fix a failure when using garble inside a go.work workspace
  • Fail early and clearly if the Go version is too new
  • Rewrite the main go generate script from Bash to Go and improve it

v0.12.1

18 Feb 11:49
v0.12.1
ea3674e
Compare
Choose a tag to compare

This bugfix release fixes a regression in v0.12.0 that broke x/sys/unix. See #830.

v0.12.0

10 Feb 10:54
v0.12.0
f3f57e3
Compare
Choose a tag to compare

This release continues support for Go 1.21 and includes fixes for Go 1.22, now that the final 1.22.0 release is out.

@lu4p improved the detection of types used with reflection to track make calls too, fixing more cannot use T1 as T2 errors when obfuscating types. See #690.

@pagran added a trash block generator to the control flow obfuscator. See #825.

A number of bugfixes are also included:

  • Avoid an error when building for GOOS=ios - #816
  • Prevent the shuffle literal obfuscation from being optimized away - #819
  • Support inline comments in assembly #include lines - #812

v0.11.0

03 Dec 13:10
v0.11.0
02175c5
Compare
Choose a tag to compare

This release drops support for Go 1.20, continues support for Go 1.21, and adds initial support for the upcoming Go 1.22.

@lu4p and @mvdan improved the code using SSA to detect which types are used with reflection, which should fix a number of errors such as cannot use T1 as T2 or cannot convert T1 to T2. See: #685, #763, #782, #785, #807.

@pagran added experimental support for control flow obfuscation, which should provide stronger obfuscation of function bodies when enabled. See the documentation at docs/CONTROLFLOW.md. See #462.

A number of bugfixes are also included:

  • Avoid panicking on a struct embedding a builtin alias - #798
  • Strip struct field tags when hashing struct types for type identity - #801

v0.10.1

25 Jun 20:42
v0.10.1
Compare
Choose a tag to compare

This bugfix release continues support for Go 1.20 and the upcoming 1.21, and features:

  • Avoid obfuscating local types used for reflection, like in go-spew - #765

v0.10.0

05 Jun 21:08
v0.10.0
d376314
Compare
Choose a tag to compare

This release drops support for Go 1.19, continues support for Go 1.20, and adds initial support for the upcoming Go 1.21.

@lu4p rewrote the code to detect whether reflect is used on each Go type, which is used to decide which Go types should not be obfuscated to prevent breakage. The old code analyzed syntax trees with type information, which is cheap but clumsy. The new code uses SSA, which adds a bit of CPU cost to builds, but allows for a more powerful analysis that is less likely to break on edge cases. While this change does slow down builds slightly, we will start using SSA for more features in the near term, such as control flow obfuscation. See #732.

@pagran improved the patching of Go's linker to also obfuscate funcInfo.entryoff, making it harder to relate a function's metadata with its body in the binary. See #641.

@mvdan rewrote garble's caching to be more robust, avoiding errors such as "cannot load garble export file". The new caching system is entirely separate from Go's GOCACHE, being placed in GARBLE_CACHE, which defaults to a directory such as ~/.cache/garble. See #708.

@DominicBreuker taught -literals to support obfuscating large string literals by using the "simple" obfuscator on them, as it runs in linear time. See #720.

@mvdan added support for garble run, the obfuscated version of go run, to quickly test that a main program still works when obfuscated. See #661.

A number of bugfixes are also included:

  • Ensure that sync/atomic types are still aligned by the compiler - #686
  • Print the chosen random seed when using -seed=random - #696
  • Avoid errors in git apply if the system language isn't English - #698
  • Avoid a panic when importing a missing package - #694
  • Suggest a command when asking the user to rebuild garble - #739

v0.9.3

12 Feb 18:00
v0.9.3
Compare
Choose a tag to compare

This bugfix release continues support for Go 1.19 and 1.20, and features:

  • Support inline comments in assembly to fix GOARCH=ppc64 - #672
  • Avoid obfuscating reflect.Value to fix davecgh/go-spew - #676
  • Fix runtime panics when using garble build inside a VCS directory - #675

Thanks to @pagran and @lu4p for their contributions!

v0.9.2

07 Feb 17:22
v0.9.2
Compare
Choose a tag to compare

This bugfix release continues support for Go 1.19 and 1.20, and features:

  • Support go:linkname directives referencing methods - #656
  • Fix more "unused import" errors with -literals - #658

Thanks to @pagran and @lu4p for their contributions!

v0.9.1

26 Jan 11:53
v0.9.1
Compare
Choose a tag to compare

This bugfix release continues support for Go 1.19 and the upcoming Go 1.20, and features:

  • Support obfuscating code which uses "dot imports" - #610
  • Fix linking errors for MIPS architectures - #646
  • Compiler intrinsics for packages like math/bits work again - #655

Thanks to @pagran and @lu4p for their contributions!