"{ Encoding: utf8 }"

"

 COPYRIGHT (c) 2003 by eXept Software AG

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libbasic2' }"

"{ NameSpace: Smalltalk }"

CRCStream subclass:#CRC32Stream

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	category:'System-Crypt-Hashing'

!

CRC32Stream subclass:#CRC32Stream_Castagnoli

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	privateIn:CRC32Stream

!

!CRC32Stream primitiveDefinitions!

%{

#if defined(__x86__) || defined(__x86_64__)

# if defined(__GNUC__)

#  pragma GCC push_options

#  pragma GCC target ("arch=core-avx2")

#  define HAS_CRC

# endif

# if defined(__clang__)

#  define HAS_CRC

# endif

# if defined(__MINGW__)

   typedef unsigned int   uint32_t;

   typedef unsigned short uint16_t;

   typedef unsigned char  uint8_t;

# endif

#ifdef HAS_CRC

# ifdef __LP64__

  asm("crc32q %[value], %[crc]\n" : [crc] "+r" (crc) : [value] "rm" (value));

  return crc;

}

# endif

static inline uint32_t __crc32_u32(uint32_t crc, uint32_t value) {

  asm("crc32l %[value], %[crc]\n" : [crc] "+r" (crc) : [value] "rm" (value));

  return crc;

}

static inline uint32_t __crc32_u16(uint32_t crc, uint16_t value) {

  asm("crc32w %[value], %[crc]\n" : [crc] "+r" (crc) : [value] "rm" (value));

  return crc;

}

static inline uint32_t __crc32_u8(uint32_t crc, uint8_t value) {

  asm("crc32b %[value], %[crc]\n" : [crc] "+r" (crc) : [value] "rm" (value));

  return crc;

}

# endif // HAS_CRC

#endif // x86 or x86_64

%}

! !

!CRC32Stream class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 2003 by eXept Software AG

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    Only use CRC to protect against communication errors;

    DO NOT use CRC for cryptography, authentication, security, etc.

    - use secure hashes for those instead.

    Standard CRC method as defined by ISO 3309 [ISO-3309] or ITU-T V.42 [ITU-T-V42].

    The default CRC polynomial employed is

    You can also create an instace performing the Castagnoli CRC-32C

    (used in iSCSI & SCTP [RFC3720], G.hn payload, SSE4.2):

    Notice that this CRC is also used with PNG images;

    therefore, its performance directly affects png image processing (png write speed).

    throughput:

     new:

    [author:]

    [instance variables:]

    [class variables:]

    [see also:]

"

!

examples

"

  expect 60C1D0A0

    self information:(CRC32Stream hashValueOf:'resume') hexPrintString

  expect 16r60C1D0A0

    self information:(CRC32Stream new

  expect 16r70E46888:

    self information:(CRC32Stream hashValueOf:#[1 2 3 4 5 6 7]) hexPrintString

  expect 16r8CD04C73:

    self information:((CRC32Stream hashValueOf:#[16rFF 16rFF 16rFF 16rFF 16rFF 16rFF 16rFF 16rFF 16rFF 16rFF

  timing throughput:

  230Mb/s (on MacBook Pro 2012 / 2.6Ghz I7)

    |hashStream n t|

    hashStream := CRC32Stream new.

    n := 2000000.

    t := Time millisecondsToRun:[

    t := (t / 1000) asFloat.

    Transcript show:'crc32:'; showCR: hashStream hashValue hexPrintString.

    Transcript show:t; show:' seconds for '; show:(50*n/1024) asFloat; showCR:' Kb'.

    Transcript show:(n*50/1024 / t); showCR:' Kb/s'

  500Mb/s (on MacBook Pro 2012 / 2.6Ghz I7)

    |hashStream n t|

    hashStream := CRC32Stream newCastagnoli.

    n := 2000000.

    t := Time millisecondsToRun:[

    t := (t / 1000) asFloat.

    Transcript show:'crc32:'; showCR: hashStream hashValue hexPrintString.

    Transcript show:t; show:' seconds for '; show:(50*n/1024) asFloat; showCR:' Kb'.

    Transcript show:(n*50/1024 / t); showCR:' Kb/s'

  the real speed is shown with longer inputs...

    |hashStream n t l s|

    hashStream := CRC32Stream newCastagnoli.

    n := 20000.

    s := '1234567890' ,* 10000.

    l := s size.

    t := Time millisecondsToRun:[

    t := (t / 1000) asFloat.

    Transcript show:'crc32:'; showCR: hashStream hashValue hexPrintString.

    Transcript show:t; show:' seconds for '; show:(l*n/1024) asFloat; showCR:' Kb'.

    Transcript show:(n*l/1024/1024 / t); showCR:' Mb/s'

  test vectors from https://tools.ietf.org/html/rfc3720#page-217:

  expect 0

    self information:(CRC32Stream newCrc32c hashValueOf:'') hexPrintString

  expect C1D04330

    self information:(CRC32Stream newCrc32c hashValueOf:'a') hexPrintString

  expect E3069283

    self information:(CRC32Stream newCrc32c hashValueOf:'123456789') hexPrintString

  expect 8A9136AA

    self information:(CRC32Stream newCrc32c hashValueOf:(ByteArray new:32 withAll:0)) hexPrintString

  expect 62a8ab43

    self information:(CRC32Stream newCrc32c hashValueOf:(ByteArray new:32 withAll:16rFF)) hexPrintString

  expect 46dd794e

    self information:(CRC32Stream newCrc32c hashValueOf:(0 to:31) asByteArray) hexPrintString

"

! !

!CRC32Stream class methodsFor:'instance creation'!

generatorPolynomMSB:anInteger

    "notice, in literature, the generator polynom is usually specified as an MSB number"

    ^ self generatorPolynom:(anInteger bitReversed32)

    "

       self assert:((self generatorPolynom:16r82F63B78)

				nextPut:'123456789';

				hashValue)    = 16rE3069283

    "

    "Created: / 16-03-2019 / 20:55:46 / Claus Gittinger"

!

generatorPolynomMSB:anInteger initValue:initValueArg

    "notice, in literature, the generator polynom is usually specified as an MSB number"

    ^ self generatorPolynom:(anInteger bitReversed32) initValue:initValueArg

    "Created: / 16-03-2019 / 21:11:31 / Claus Gittinger"

!

generatorPolynomMSB:anInteger initValue:initValueArg xorOut:xorOut

    "notice, in literature, the generator polynom is usually specified as an MSB number"

    ^ self generatorPolynom:(anInteger bitReversed32) initValue:initValueArg xorOut:xorOut

    "Created: / 16-03-2019 / 21:21:27 / Claus Gittinger"

!

new

    "return an instance of the ITU-T CRC-32"

    ^ self newCCITT

    "Created: / 16-03-2019 / 21:09:19 / Claus Gittinger"

    "Modified: / 16-03-2019 / 23:29:45 / Claus Gittinger"

    "Modified (comment): / 17-03-2019 / 14:34:47 / Claus Gittinger"

!

newCCITT

    "return an instance of the ITU-T CRC-32

	x^32+x^26+x^23+x^22+x^16+x^12+x^11+x^10+x^8+x^7+x^5+x^4+x^2+x+1"

    "/ 16r4C11DB7 bitReversed32 -> 16rEDB88320

    ^ self generatorPolynomMSB:16r4C11DB7

	   initValue:16rFFFFFFFF xorOut:16rFFFFFFFF

    "Created: / 16-03-2019 / 23:29:39 / Claus Gittinger"

    "Modified: / 17-03-2019 / 14:07:36 / Claus Gittinger"

!

newCastagnoli

    "return an instance of the Castagnoli CRC-32

	x32 + x28 + x27 + x26 + x25 + x23 + x22 + x20 + x19 + x18 + x14 + x13 + x11 + x10 + x9 + x8 + x6 + 1

     (used in iSCSI & SCTP, G.hn payload, SSE4.2)"

    |impl|

    impl := (self canUseFastCRC) ifTrue:[CRC32Stream_Castagnoli] ifFalse:[self].

    "/ 16r1edc6f41 bitReversed32 -> 16r82F63B78

    ^ impl generatorPolynomMSB:16r1edc6f41

	   initValue:16rFFFFFFFF xorOut:16rFFFFFFFF

    "

     Castagnoli crc:

       self assert:((self newCrc32c)

				nextPut:'123456789';

				hashValue) = 3808858755. '16rE3069283'

     default crc:

       self assert:((self new)

				nextPut:'123456789';

				hashValue) = 3421780262. '16rCBF43926'

    "

    "Created: / 17-03-2019 / 14:33:54 / Claus Gittinger"

    "Modified: / 17-03-2019 / 17:08:32 / Claus Gittinger"

!

newCrc32c

    "return an instance of the Castagnoli CRC-32"

    ^ self newCastagnoli

    "

     Castagnoli crc:

       self assert:((self newCrc32c)

				nextPut:'123456789';

				hashValue) = 3808858755. '16rE3069283'

     default crc:

       self assert:((self new)

				nextPut:'123456789';

				hashValue) = 3421780262. '16rCBF43926'

    "

    "Modified (comment): / 17-05-2012 / 12:48:53 / cg"

    "Modified: / 17-03-2019 / 14:34:26 / Claus Gittinger"

! !

!CRC32Stream class methodsFor:'private'!

canUseFastCRC

%{ /* NOCONTEXT */

#if defined(HAS_CRC)

# if defined(__x86__) || defined(__x86_64__)

#  if defined(__clang__) || defined(__GNUC__)

    extern unsigned char __cpu_hasSSE4_2;

    RETURN (__cpu_hasSSE4_2 ? true : false);

#  endif

# endif

#endif

%}.

    ^ false

    "

     self canUseFastCRC

    "

    "Created: / 17-03-2019 / 16:45:42 / Claus Gittinger"

! !

!CRC32Stream methodsFor:'initialization'!

generatorPolynom:anLSBInteger

    "set the generator polynom for this instance.

     set start and xorOut to 16rFFFFFFFF.

     Note: you have to set the bit-reversed value, so the LSB must be first"

    self generatorPolynom:anLSBInteger

	 initValue:16rFFFFFFFF xorOut:16rFFFFFFFF.

    "Modified: / 16-03-2019 / 21:23:25 / Claus Gittinger"

    "Modified (format): / 17-03-2019 / 14:02:38 / Claus Gittinger"

!

generatorPolynom:anLSBInteger initValue:initValueArg

    "set the generator polynom for this instance.

     set start to initValueArg and xorOut to 16rFFFFFFFF.

     Note: you have to set the bit-reversed value, so the LSB must be first"

    self generatorPolynom:anLSBInteger

	 initValue:initValueArg xorOut:16rFFFFFFFF

    "Created: / 16-03-2019 / 21:06:16 / Claus Gittinger"

    "Modified (format): / 17-03-2019 / 14:02:31 / Claus Gittinger"

! !

!CRC32Stream::CRC32Stream_Castagnoli class methodsFor:'documentation'!

documentation

"

    redefined to use the CPU's CRC instruction

    [author:]

	Claus Gittinger

"

! !

!CRC32Stream::CRC32Stream_Castagnoli methodsFor:'writing'!

nextPutBytes:count from:anObject startingAt:start

    "add the hash of anObject to the computed hash so far.

     This uses the x86/x86_64 crc instruction,

     and works only for the castagnoli polynom"

%{  /* NOCONTEXT */

#if defined(HAS_CRC)

    if (__bothSmallInteger(count, start)) {

	int len, offs;

	int objSize;

	unsigned char *extPtr;

	len = __intVal(count);

	offs = __intVal(start) - 1;

	if (__isExternalBytesLike(anObject)) {

	    OBJ sz = __externalBytesSize(anObject);

	    extPtr = (unsigned char *)__externalBytesAddress(anObject);

	    if (__isSmallInteger(sz)) {

		objSize = __intVal(sz);

	    } else {

		objSize = 0; /* unknown */

	    }

	} else {

	    int nInstVars, nInstBytes;

	    OBJ oClass = __Class(anObject);

	    switch (__intVal(__ClassInstPtr(oClass)->c_flags) & ARRAYMASK) {

		case BYTEARRAY:

		case WORDARRAY:

		case LONGARRAY:

		case SWORDARRAY:

		case SLONGARRAY:

		case FLOATARRAY:

		case DOUBLEARRAY:

		    break;

		default:

		    goto bad;

	    }

	    nInstVars = __intVal(__ClassInstPtr(oClass)->c_ninstvars);

	    nInstBytes = __OBJS2BYTES__(nInstVars);

	    // nInstBytes is the number of bytes occupied by pointer instance variables

	    // subtract from size and add to byte-pointer

	    objSize = __qSize(anObject) - OHDR_SIZE - nInstBytes;

	    extPtr = (unsigned char *)__byteArrayVal(anObject)+nInstBytes;

	}

	if ((offs >= 0) && (len >= 0) && (objSize >= (len + offs))) {

	    unsigned int _crc;

	    unsigned int *_crcTable = __integerArrayVal( __INST(crcTable) );

	    unsigned char *cp = extPtr+offs;

	    unsigned int n = len;

	    if (__isSmallInteger(__INST(crc))) {

		_crc = (unsigned int) (__intVal( __INST(crc) ));

	    } else {

		_crc = __unsignedLongIntVal( __INST(crc) );

	    }

# if __POINTER_SIZE__ == 8