Initial commit from https://github.com/fireeye/gocrack

.gitignore

@@ -0,0 +1 @@
+.vscode

LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Christopher Schmitt, FireEye
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,24 @@
+# gocat
+
+gocat is a cgo library for interacting with libhashcat. gocat enables you to create purpose-built password cracking tools that leverage the capabilities of [hashcat](https://hashcat.net/hashcat/).
+
+## Installation
+
+gocat requires hashcat [v5.1.0](https://github.com/hashcat/hashcat/releases) or higher to be compiled as a shared library. This can be accomplished by modifying hashcat's `src/Makefile` and setting `SHARED` to `1`
+
+Installing the Go Library:
+
+    go get github.com/fireeye/gocat
+
+## Known Issues
+
+* Lack of Windows Support: This won't work on windows as I haven't figured out how to build hashcat on windows
+* Memory Leaks: hashcat has several (small) memory leaks that could cause increase of process memory over time
+
+## Contributing
+
+Contributions are welcome via pull requests provided they meet the following criteria:
+
+1. One feature or bug fix per PR
+1. Code should be properly formatted (using go fmt)
+1. Tests coverage should rarely decrease. All new features should have proper coverage

ctypes.go

@@ -0,0 +1,20 @@
+package gocat
+
+// #include <stdlib.h>
+import "C"
+import "unsafe"
+
+var cChar *C.char
+
+// convertArgsToC converts go strings into a **C.char.
+// The results of this MUST be free'd
+func convertArgsToC(args ...string) (C.int, **C.char) {
+	ptrSize := unsafe.Sizeof(cChar)
+	ptr := C.malloc(C.size_t(len(args)) * C.size_t(ptrSize))
+
+	for i := 0; i < len(args); i++ {
+		element := (**C.char)(unsafe.Pointer(uintptr(ptr) + uintptr(i)*ptrSize))
+		*element = C.CString(string(args[i]))
+	}
+	return C.int(len(args)), (**C.char)(ptr)
+}

doc.go

@@ -0,0 +1,7 @@
+/*
+Package gocat is a cgo interface around libhashcat. It's main purpose is to abstract hashcat and allow you to build tools in Go that leverage the hashcat engine.
+
+gocat should be used with libhashcat v5.1.0 as previous versions have known memory leaks and could affect long running processes running multiple cracking tasks.
+
+*/
+package gocat

go.mod

@@ -0,0 +1,5 @@
+module github.com/fireeye/gocat
+
+go 1.12
+
+require github.com/stretchr/testify v1.3.0

go.sum

@@ -0,0 +1,7 @@
+github.com/davecgh/go-spew v1.1.0 h1:ZDRjVQ15GmhC3fiQ8ni8+OwkZQO4DARzQgrnXU1Liz8=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/testify v1.3.0 h1:TivCn/peBQ7UY8ooIcPgZFpTNSz0Q2U6UrFlUfqbe0Q=
+github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=