ASN1

Module Implementation: OpenSSLCryptoInterfaceASN1

This module wraps various data structures defined in ASN1 (Abstract Syntax Notation One).

Note: Internal classes are italicized and will only contain a short description.

ASN1 Types

OSSslAsn1Integer

This class represents the ASN1 Integer built-in type. This can be arbitrarily large and has conversion methods to/from Smalltalk Integers.

Class methods: Creation

createNew

Create a new ASN1 Integer instance.

Answers:

<OSSslAsn1Integer> - new instance

<OpenSSLError compatible error> - error object

 

createNewFromBigNumber: aBigNumber

Create a new ASN1 Integer instance from aBigNumber <OSSslBigNumber>

Answers:

<OSSslAsn1Integer> - new instance

<OpenSSLError compatible error> - error object

 

createNewFromInteger: anInteger

Create a new ASN1 Integer instance from anInteger <Integer>

Answers:

<OSSslAsn1Integer> - new instance

<OpenSSLError compatible error> - error object

 

Instance methods: Accessing

value

Answers the Smalltalk Integer representation of the data element

of the ASN1_INTEGER structure.

Answers:

<Integer> - ASN1Integer as a Smalltalk Integer

 

value: anInteger

Sets the value of this ASN1Integer to anInteger

Arguments:

anInteger - <Integer> long integer value

 

Instance methods: Comparison

compare: anASN1Integer

Answer the comparison value (semantics described in OSSslStructure>>compare:)

Answers:

<Integer>

 

Instance methods: Conversion

asInteger

Answer a Smalltalk Integer that represents the value of this ASN1 Integer

Answers:

<Integer>

 

asOpenSSLAsn1Integer

Answer myself as a new object reference.

Answers:

<OSSslAsn1Integer>

 

asOpenSSLBigNumber

Converts this ASN1_INTEGER into a BIGNUM

Answers:

<OSSslBigNumber> - new instance of big number

 

asString

Converts this ASN1_INTEGER into a Smalltalk String.

Answers:

<String>

 

Instance methods: Duplication

duplicate

Answers a managed duplicate of this ASN1 Integer.

Answers:

<OSSslAsn1Integer> - new duplicate instance

 

OSSslAsn1String

This class represents the ASN1 String built-in type.

Class methods: Creation

createNew

Create a new ASN1 Integer instance.

Answers:

<OSSslAsn1Integer> - new instance

 

createNewFromBytes: aByteObject

Answer a new ASN1 string from aByteObject.

The argument must be one that converts to bytes in a platform function.

Arguments:

aByteObject - @see implementors of isOpenSSLByteObject for types

Answers:

<OSSslAsn1String> - new instance

 

createNewFromBytes: anOSObjectOrByteArray length: length

Answer a new ASN1 string from anOSObjectOrByteArray.

The argument must be one that converts to bytes in a platform

function.

Arguments:

anOSObjectOrByteArray - <ByteArray> or byte type <OSObject>

length - <Integer> set up to @length amount from the @anOSObjectOrByteArray

Answers:

<OSsslAsn1String> - new instance

 

createNewFromType: type

Create the new instance of the the ASN1 String of the given type.

See V_ASN1_* types in SciSslConstants pool dictionary for types.

Answers:

<OSSslAsn1String> - new instance

 

Instance methods: Comparison

compare: anASN1String

Answer the comparison value (semantics described in OSSslStructure>>compare:)

Answers:

<Integer>

 

Instance methods: Conversion

asByteArray

Convert the ASN1 String to a Smalltalk Byte Array

Answers:

<ByteArray> - byte representation

 

asBytes

Convert the ASN1 String to a Smalltalk Byte Array

Answers:

<ByteArray> - byte representation

 

asOpenSSLAsn1String

Answer a new Smalltalk object reference

to the same ASN1_STRING memory.

This object will NOT own the memory

Answers:

< OSSslAsn1String>

 

asString

Converts this ASN1 String into a Smalltalk String.

Answers:

<String>

 

Instance methods: Duplication

duplicate

Answers a managed duplicate of this ASN1 String.

Answers:

<OSSslAsn1String> - new duplicate instance

 

OSSslAsn1Time

This class represents the ASN1 Generalized and UTC time types. Internally, this time is stored in UTC but has conversion routines to convert to generalized time. This class also has conversion routines for Smalltalk's DateAndTime.

Class methods: Creation

createNew

Create the new instance of the the ASN1_TIME object. This will be UTC time.

Answers:

< OSSslAsn1Time> - new instance of type V_ASN1_UTCTIME

createNewFromDateAndTime: aDateAndTime

Create a new instance of the ASN1_TIME object from the Smalltalk <DateAndTime> object (which is converted to UTC).

Arguments:

aDateAndTime - <DateAndTime>

Answers:

<OSSslAsn1Time> - new instance with value set from arg

 

createNewFromString: aUTCFormattedString

Create a new instance of the ASN1_TIME object from the Smalltalk <String> object which described a UTC formatted time.

Arguments:

aUTCFormattedString - <String>

Answers:

<OSSslAsn1Time> - new instance with value set from arg

 

Instance methods: API

isValid

Validation check on the ASN1 Time object

Answers:

<Boolean> - true if valid, false otherwise.

 

setDateAndTime: aDateAndTime

Set the ASN1_TIME formatted date time derived from the Smalltalk <DateAndTime> object converted

to UTC.

Arguments:

aDateAndTime - <DateAndTime> converted to UTC

Answers:

<Integer> - 1 on success, otherwise an error object

 

Instance methods: Conversion

asDateAndTime

Answer a new UTC <DateAndTime> object from this ASN1_TIME

Answers:

<DateAndTime> - utc

 

asDateAndTimeLocal

Answer a new Local <DateAndTime> object from this ASN1_TIME

Answers:

<DateAndTime> - local

 

asDateAndTimeUTC

Answer a new UTC <DateAndTime> object from this ASN1_TIME

Answers:

<DateAndTime> - utc

 

asOpenSSLAsn1Time

Answer a new Smalltalk object reference to the same ASN1_TIME memory.

Answers:

<OSSslAsn1Time> - new reference

 

asString

Convert this ASN1_TIME to a Smalltalk String

Answers:

< String>

Extensions

DateAndTime

 

asOpenSSLAsn1Time

Answer a new OpenSSL ASN1_TIME date and time with the value of this DateAndTime (converted to UTC)

Answers:

<OSSslAsn1Time>

Integer

 

asOpenSSLAsn1Integer

Answer a new OpenSSL ASN1_INTEGER with the value of this Integer.

Answers:

< OSSslAsn1Integer>

String

 

asOpenSSLAsn1String

Answer a new OpenSSL ASN1_STRING with the value of this Smalltalk String.

Answers:

< OSSslAsn1String>

 

asOpenSSLAsn1Time

Answer a new OpenSSL ASN1_TIME date and time with the value of this UTC Formatted String.

Answers:

< OSSslAsn1Time>