https://github.com/wthorp/GoSMB

SMB server written in Go
https://github.com/wthorp/GoSMB

Last synced: about 2 months ago
JSON representation

SMB server written in Go

• Host: GitHub
• URL: https://github.com/wthorp/GoSMB
• Owner: wthorp
• License: apache-2.0
• Created: 2019-04-18T03:19:47.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-12-28T11:16:53.000Z (over 3 years ago)
• Last Synced: 2024-06-20T13:30:44.359Z (3 months ago)
• Language: Go
• Size: 1.86 MB
• Stars: 38
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# GoSMB

SMB server written in Go

This document is laying out a plan for implementing an SMB server entirely in Go.

## Potential methods

1. Transpile existing implementation to Go

2. Hand port existing implementation to Go

3. Build Go implementation from scratch using existing Go libraries

4. The most likely solution : some combination of the above

## Likely relavent Go Code

* [stacktitan/smb](https://github.com/stacktitan/smb)

* [go-ntlmssp](https://github.com/Azure/go-ntlmssp)

* [gokrb5](https://github.com/jcmturner/gokrb5)

## Reference texts

* https://en.wikipedia.org/wiki/Server_Message_Block

* https://en.wikipedia.org/wiki/NetBIOS

* https://www.samba.org/ftp/tridge/misc/french_cafe.txt

* https://www.samba.org/ftp/samba/specs/

* TODO:  more here

## Minimum viable target

* SMB can run on TCP without NETBIOS.  I can't find a Go NETBIOS library, so it may be easier without it.

* TODO:  more here

## Impacket

[Impacket](https://github.com/SecureAuthCorp/impacket) is interesting for a few of reasons.  

1. Its written in Python and the [Grumpy](https://github.com/google/grumpy) transpiler is well known.

2. Impacket was authored for pen-testing and has some other interesting protocols / code.

3. The Python [grammar](https://docs.python.org/3/reference/grammar.html) is well documented.

### Transpiling with Grumpy

Initial attempts at transpiling via Grumpy were slow going.

The codebase uses eval(), various "futures", and other features known to not work with Grumpy.

No support for the crucial [struct](https://docs.python.org/2/library/struct.html) standard library.

### Transpiling with custom ANTLR4 and go/ast

I've generated code with go/ast before.  I was able to generate Go code from the Python grammar using ANTLR4.  

The volume of things it generated was a little overwhelming, and I didn't really try to understand it.

I'm wondering if goyacc might be simpler.

### Hand Porting

The impacket codebase relies heavily on [struct](https://docs.python.org/2/library/struct.html) packing.

It uses a string syntax to identify serialization characteristic and default values.

In most cases, this struct syntax ports trivially, EG:

`('InputCount','