You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
50 lines
1.6 KiB
50 lines
1.6 KiB
10 years ago
|
// Package erasure is a Go wrapper for the Intel Intelligent Storage
|
||
|
|
// Acceleration Library (Intel ISA-L). Intel ISA-L is a CPU optimized
|
||
|
|
// implementation of erasure code.
|
||
|
|
//
|
||
|
|
// For more information on Intel ISA-L, please visit:
|
||
|
|
// https://01.org/intel%C2%AE-storage-acceleration-library-open-source-version
|
||
|
|
//
|
||
|
|
// Usage
|
||
|
|
//
|
||
|
|
// TODO: Explain Encode and Decode inputs and outputs
|
||
|
|
//
|
||
|
|
// TODO: Explain matrix size and how it corresponds to protection level
|
||
|
|
//
|
||
|
|
// Encoding data may be performed in 3 steps.
|
||
|
|
//
|
||
|
|
// 1. Create a validated set of encoder parameters
|
||
|
|
// 2. Create a new encoder
|
||
|
|
// 3. Encode data
|
||
|
|
//
|
||
|
|
// Decoding data is also performed in 3 steps.
|
||
|
|
//
|
||
|
|
// 1. Create a validated set of encoder parameters
|
||
|
|
// 2. Create a new encoder
|
||
|
|
// 3. Decode data
|
||
|
|
//
|
||
|
|
// Encoder parameters contain four configurable elements:
|
||
|
|
// ValidateParams(k, m, w, technique int) (EncoderParams, error)
|
||
|
|
// k - Number of rows in matrix
|
||
|
|
// m - Number of colums in matrix
|
||
|
|
// w - Word size, typically 8 or aligned by 8.
|
||
|
|
// technique - Matrix type, can be either CAUCHY (recommended) or VANDERMONDE
|
||
|
|
// constraints: k + m < 256
|
||
|
|
//
|
||
|
|
// Example
|
||
|
|
//
|
||
|
|
//
|
||
|
|
// Creating and using an encoder
|
||
|
|
// var bytes []byte
|
||
|
|
// params := erasure.ValidateParams(10,5, 8, erasure.CAUCHY)
|
||
|
|
// encoder := erasure.NewEncoder(params)
|
||
|
|
// encodedData, length := encoder.Encode(bytes)
|
||
|
|
//
|
||
|
|
// Creating and using a decoder
|
||
|
|
// var encodedData [][]byte
|
||
|
|
// var length int
|
||
|
|
// params := erasure.ValidateParams(10,5, 8, erasure.CAUCHY)
|
||
|
|
// encoder := erasure.NewEncoder(params)
|
||
|
|
// originalData, err := encoder.Decode(encodedData, length)
|
||
|
|
package erasure
|