First commit

.gitignore

@@ -0,0 +1,2 @@
+lto-info
+lto-info.1

Makefile

@@ -0,0 +1,22 @@
+EXE = lto-info
+MAN = $(EXE).1
+
+all: $(EXE) $(MAN)
+
+clean:
+	rm -f $(EXE) $(MAN)
+
+$(EXE): *.go
+	go fmt *.go
+	go build -o $(EXE) *.go
+
+$(MAN): $(EXE)
+	./$(EXE) --man > $(MAN)
+
+.PHONY: run fmt
+
+run: $(EXE)
+	./$(EXE)
+
+fmt: *.go
+	go fmt *.go

README.md

@@ -0,0 +1,77 @@
+LTO Info Tool
+=============
+
+This tool reads the internal memory of LTO/Ultrium cartridges from a tape drive
+
+More precisely, this tool can:
+- Read, decode and display factory and usage information stored in the Cartridge Memory (`CM`) aka Medium Auxiliary Memory (`MAM`)
+- View and modify the custom `User Medium Text Label` of a cartridge
+- Display basic information about the tape drive device
+
+## How to build and use
+
+You need to have a go build environment [properly set up](https://golang.org/doc/install), then just type:
+
+```
+make
+```
+
+And try the tool by typing:
+
+```
+./lto-info
+```
+
+By default, the tool will look for a tape device in `/dev/nst0`, or what is pointed to by the `TAPE` environment variable. To specify another device, use the `-d` option.
+
+## Output example
+```
+Drive information:
+   Vendor  : HP
+   Model   : Ultrium 2-SCSI
+   Firmware: F63D
+Medium information:
+  Cartridge Type: 0x01 - Cleaning cartridge (50 cycles max)
+  Medium format : 0x42 - LTO-2
+  Formatted as  : 0x42 - LTO-2
+  Assign. Org.  : LTO-FAKE
+  Manufacturer  : FAKMANUF
+  Serial No     : 123456789
+  Manuf. Date   : 2019-12-31 (roughly 1.3 years ago)
+  Tape length   : 999 meters
+  Tape width    : 11.1 mm
+  MAM Capacity  : 4096 bytes (850 bytes remaining)
+Format specs:
+   Capacity  :   200 GB native   -   400 GB compressed with a 2:1 ratio
+   R/W Speed :    40 MB/s native -    80 MB/s compressed
+   Partitions:     1 max partitions supported
+   Phy. specs: 4 bands/tape, 16 wraps/band, 8 tracks/wrap, 512 total tracks
+   Duration  : 1h23 to fill tape with 64 end-to-end passes (78 seconds/pass)
+Usage information:
+  Partition space free  : 98% (198423/200448 MiB, 193/195 GiB, 0.19/0.19 TiB)
+  Cartridge load count  : 42
+  Data written - alltime:        17476 MiB (    17.07 GiB,   0.02 TiB, 0.09 FVE)
+  Data read    - alltime:        15827 MiB (    15.46 GiB,   0.02 TiB, 0.08 FVE)
+  Data written - session:            0 MiB (     0.00 GiB,   0.00 TiB, 0.00 FVE)
+  Data read    - session:          139 MiB (     0.14 GiB,   0.00 TiB, 0.00 FVE)
+Previous sessions:
+  Session N-0: Used in a device of vendor FAKEVEND (serial MODEL012345678901234567890123456)
+  Session N-1: Used in a device of vendor FAKEVEND (serial MODEL12345)
+  Session N-2: Used in device ACMEINC
+  Session N-3: Used in a device of vendor FAKEVEND (serial MODEL34567)
+```
+
+## Build-time dependencies
+
+- https://github.com/HewlettPackard/structex: encode/decode bitfields in SCSI structs in a readable way
+- https://github.com/benmcclelland/mtio: go bindings for `mt` ioctls
+- https://github.com/benmcclelland/sgio: go bindings for `sgio` ioctls
+- https://github.com/jessevdk/go-flags: command-line options parser
+
+## Related
+
+Inspired from other tools written in C:
+- https://github.com/arogge/maminfo
+- https://github.com/scangeo/lto-cm/
+
+Big up to them!