README
¶
gotgt 
gotgt is a simple SCSI Target framework implemented by golang, built for performance and density..
What is SCSI?
Small Computer System Interface (SCSI) is a set of standards for physically connecting and transferring data between computers and peripheral devices. The SCSI standards define commands, protocols, electrical and optical interfaces. SCSI is most commonly used for hard disk drives and tape drives, but it can connect a wide range of other devices, including scanners and CD drives, although not all controllers can handle all devices.
What is iSCSI?
The iSCSI is an acronym for Internet Small Computer Systems Interface, an Internet Protocol (IP)-based storage networking standard for linking data storage facilities. In a nutshell, it provides block-level access to storage devices over a TCP/IP network.
Getting started
Currently, the gotgt is under heavy development, so there is no any release binaries so far, you have to build it from source.
There is a only on binary name gotgt, you can start a daemon via gotgt daemon and control it via gotgt list/create/rm.
Build
You will need to make sure that you have Go installed on your system and the gotgt repository is cloned in your $GOPATH.
$ mkdir -p $GOPATH/src/github.com/gostor/
$ cd $GOPATH/src/github.com/gostor/
$ git clone https://github.com/gostor/gotgt gotgt
$ cd gotgt
$ ./autogen.sh
$ ./configure
$ make
How to use
Now, there is lack of commands to operate the target and LU, however you can init the target/LU with config file in ~/.gotgt/config.json, you may find a example at here.
Please note, if you want use that exmaple, you have to make sure file /var/tmp/disk.img is existed.
Test
You can test this with open-iscsi or libiscsi.
Performance
TBD
Roadmap
The current roadmap and milestones for alpha and beta completion are in the github issues on this repository. Please refer to these issues for what is being worked on and completed for the various stages of development.
Contributing
Want to help build gotgt? Check out our contributing documentation.
Documentation
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Godeps
|
|
|
_workspace/src/github.com/Sirupsen/logrus
Package logrus is a structured logger for Go, completely API compatible with the standard library logger.
|
Package logrus is a structured logger for Go, completely API compatible with the standard library logger. |
|
_workspace/src/github.com/coreos/go-systemd/activation
Package activation implements primitives for systemd socket activation.
|
Package activation implements primitives for systemd socket activation. |
|
_workspace/src/github.com/docker/go-connections/sockets
Package sockets provides helper functions to create and configure Unix or TCP sockets.
|
Package sockets provides helper functions to create and configure Unix or TCP sockets. |
|
_workspace/src/github.com/gorilla/context
Package context stores values shared during a request lifetime.
|
Package context stores values shared during a request lifetime. |
|
_workspace/src/github.com/gorilla/mux
Package gorilla/mux implements a request router and dispatcher.
|
Package gorilla/mux implements a request router and dispatcher. |
|
_workspace/src/github.com/satori/go.uuid
Package uuid provides implementation of Universally Unique Identifier (UUID).
|
Package uuid provides implementation of Universally Unique Identifier (UUID). |
|
_workspace/src/github.com/spf13/cobra
Package cobra is a commander providing a simple interface to create powerful modern CLI interfaces.
|
Package cobra is a commander providing a simple interface to create powerful modern CLI interfaces. |
|
_workspace/src/github.com/spf13/pflag
Package pflag is a drop-in replacement for Go's flag package, implementing POSIX/GNU-style --flags.
|
Package pflag is a drop-in replacement for Go's flag package, implementing POSIX/GNU-style --flags. |
|
_workspace/src/golang.org/x/net/context
Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes.
|
Package context defines the Context type, which carries deadlines, cancelation signals, and other request-scoped values across API boundaries and between processes. |
|
_workspace/src/golang.org/x/net/proxy
Package proxy provides support for a variety of protocols to proxy network data.
|
Package proxy provides support for a variety of protocols to proxy network data. |
|
pkg
|
|
|
api/client/transport
Package transport provides function to send request to remote endpoints.
|
Package transport provides function to send request to remote endpoints. |
|
api/client/transport/cancellable
Package cancellable provides helper function to cancel http requests.
|
Package cancellable provides helper function to cancel http requests. |
|
apiserver
Package apiserver contains the code that provides a rest.ful API service.
|
Package apiserver contains the code that provides a rest.ful API service. |
|
config
Package config contains how to get/save config parameters from file.
|
Package config contains how to get/save config parameters from file. |
|
port/iscsit
iSCSI Target Driver
|
iSCSI Target Driver |
|
scsi
Target Driver Interface SCSI block command processing SCSI primary command processing
|
Target Driver Interface SCSI block command processing SCSI primary command processing |
|
scsi/backingstore
Package backingstore provides the plugin to connect backend storage.
|
Package backingstore provides the plugin to connect backend storage. |
|
util
Package util provides some basic util functions.
|
Package util provides some basic util functions. |
|
version
Package version provides the Version information.
|
Package version provides the Version information. |