Recommendation for Space Data System Practices

#include

#include
#define IID_ISLE_Time_DEF { 7c79655c, 0x3f16, 0x47eb , \

{ 0xb6, 0xa5, 0x08, 0x63, 0x48, 0x44, 0xdd, 0xee } };

{

virtual HRESULT

Set_CDS_ToPicosecondsRes( const SLE_Octet* time ) = 0;

virtual bool

Get_PicosecondsResUsed() const = 0;

virtual SLE_Octet*

Get_CDS() const = 0;

virtual SLE_Octet*

Get_CDS_ToPicosecondsRes() const = 0;

virtual HRESULT

Set_DateAndTime( const char* dateAndTime ) = 0;

virtual HRESULT

Set_Time( const char* time ) = 0;

virtual char*

Get_Date( SLE_TimeFmt fmt ) const = 0;

virtual char*

Get_Time( SLE_TimeFmt fmt,

SLE_TimeRes res = sleTR_seconds ) const = 0;

virtual char*

Get_DateAndTime( SLE_TimeFmt fmt,

SLE_TimeRes res = sleTR_seconds ) const = 0;

virtual void

Update() = 0;

virtual double

operator- ( const ISLE_Time& time ) const = 0;

virtual bool

operator== ( const ISLE_Time& time ) const = 0;

virtual bool

operator!= ( const ISLE_Time& time ) const = 0;

virtual bool

operator< ( const ISLE_Time& time ) const = 0;

virtual bool

operator> ( const ISLE_Time& time ) const = 0;

virtual bool

operator<= ( const ISLE_Time& time ) const = 0;

virtual bool

operator>= ( const ISLE_Time& time ) const = 0;

virtual ISLE_Time*

Copy() const = 0;

};

Methods

HRESULT Set_CDS( const SLE_Octet* time );

Sets the time to the value of the argument presented in the CCSDS day segmented time code.

[G3:]

Sets the time to the value of the argument presented in the CCSDS day segmented time code to picosecond resolution.

Arguments

time time coded according to the CCSDS day segmented time code, consisting of 10 octets; the P-Field is implicit and not included

Result codes

Returns true if the time is represented in picosecond resolution, otherwise false.

Returns the time in the CCSDS day segmented time code, consisting of 8 octets; the P-Field is implicit and not included. The returned value must be deleted by the client.

Returns the time in picoseconds resolution in the CCSDS day segmented time code, consisting of 10 octets; the P-Field is implicit and not included. The returned value must be deleted by the client.

Sets the date and time to the value specified by the input argument. The ASCII string can be coded in either variant A or B of the CCSDS ASCII Calendar Segmented Time Code. The time subset must contain at least the hours. The trailing ‘Z’ may or may not be included.

Sets the time to the value specified by the input argument and the date to the current date. The ASCII string contains the time subset of the CCSDS ASCII Calendar Segmented Time Code. The time subset must contain at least the hours. The trailing ‘Z’ may or may not be included.

Returns an ASCII string with the date formatted according to the CCSDS ASCII Calendar Segmented Time Code in the variant specified by the input argument. The returned value must be deleted by the client.

Returns the time (no date) formatted according to the CCSDS ASCII Calendar Segmented Time Code in the variant and with the resolution specified by the input arguments. The optional ‘Z’ is included. The returned value must be deleted by the client.

Returns the time and date formatted according to the CCSDS ASCII Calendar Segmented Time Code in the variant and with the resolution specified by the input arguments. The optional ‘Z’ is included. The returned value must be deleted by the client.

Sets the value of the time to current time. Current time is obtained from the interface ISLE_TimeSource, if this interface was supplied to the creator-function of the component. Otherwise, the component uses system time.

Calculates the difference between the time stored and the time passed as argument and returns the difference measured in seconds and fractions of a second.

Standard comparison operators for times.

Copies the time object and returns the interface of the copy.

20. 
    SLE Service Instance Identifier
    

Objects exporting this interface handle the service instance identifier defined by the CCSDS Recommended Standards for SLE transfer services. The interface supports two formats for the service instance identifier:

1. 
   The standard format as defined by reference [17] with the constraint that the attribute are always character strings.
   
2. 
   A standard character string representation defined in the CCSDS Recommended Standards (for version 1 of the services RAF, RCF, and CLTU, this definition is provided by annex A.1.44.1.1.1.1.2 of this specification).
   

The object is able to process the standard ASCII representation for input and output.

It also accepts the standard format as defined by reference [17] and produces output in this format. For the global form of the object identifier the object uses the full object identifier presented as an array of integers. For the local form, it accepts and outputs only the trailing component of the object identifier, which is unique for all attributes used in a service instance identifier. For retrieval of the standard format, the object supports a simple built-in iterator by which the name components can be read.

The object verifies that the structure and contents of the service instance identifier conforms to the specifications provided in the CCSDS Recommended Standards for SLE transfer services (for version 1 to the specification in annex A.1.44.1.1.1.1.2).

After creation the value of the service instance identifier is NULL.

After creation, the format to be used is set to the one defined in the CCSDS Recommended Standards for SLE transfer services. To use the initial format defined in annex A.1.44.1.1.1.1.2, the method Set_InitialFormat() must be called. Support for the initial format is optional and implementations not supporting this format shall return an error when the method is called.

#include

{ 0xaa, 0x17, 0xba, 0x8b, 0x51, 0xa, 0xec, 0x20 } }

{

virtual bool

virtual HRESULT

Set_InitialFormat() = 0;

virtual char*

Get_AsciiForm() const = 0;

virtual char*

GetLastRDN() const = 0;

virtual HRESULT

Set_AsciiForm( const char* siiString ) = 0;

virtual bool

IsNull() const = 0;

virtual void

SetToNull() = 0;

virtual bool

operator== ( const ISLE_SII& sii ) const = 0;

virtual bool

operator!= (const ISLE_SII& sii ) const = 0;

virtual ISLE_SII*

Copy() const = 0;

virtual HRESULT

Add_GlobalRDN( const int objId[],

size_t objIdLength,

const char* value ) = 0;

virtual HRESULT

Add_LocalRDN( int objId, const char* value ) = 0;

virtual void

Reset() = 0;

virtual bool

MoreData() = 0;

virtual HRESULT

NextGlobalRDN( int*& objId,

size_t& objIdLength,

char*& value ) = 0;

virtual HRESULT

NextLocalRDN( int& objId,

char*& value ) = 0;

};

Methods

Bool Get_InitialFormatUsed();

Returns TRUE if the initial format defined in annex A.1.44.1.1.1.1.2 is being used and FALSE otherwise.

Requests use of the initial format defined in annex A.1.44.1.1.1.1.2 of this Specification to support version 1 of the services RAF, RCF, and CLTU.

Returns the ASCII representation of the service instance identifier or the string ‘***’ if the identifier is NULL. The string must be deleted by the client.

Returns the ASCII representation of the last component of the service instance identifier or the string ‘***’ if the identifier is NULL. The string must be deleted by the client.

Parses the input string and sets the value of the service instance identifier as defined by the string. If the string is badly formatted or contains attributes that are not defined for the service instance identifier, returns an error and sets the value of the service instance identifier to NULL.

Returns true if the value if the service instance identifier is NULL.

Sets the value of service instance identifier to NULL.

The standard equality operators for service instance identifiers.

Performs a deep copy of the service instance identifier and returns the copy.

Appends a relative distinguished name (i.e., an attribute identifier-attribute value pair) to the end of the service instance identifier. If the object identifier is not defined for the service instance identifier or the value is empty, returns an error and does not add the name to service instance identifier.

Appends a relative distinguished name to the end of the service instance identifier. For this method the attribute is identified by the last component of the object identifier. If the object identifier is not defined for the service instance identifier or the value is empty, returns an error and does not add the name to service instance identifier.

Resets the internal iterator to the beginning of the service instance identifier.

Returns true when the iterator has not yet reached the end of the service instance identifier. I.e., the next to call to NextGlobalRDN() or NextLocalRDN() will return a relative distinguished name. Otherwise, returns false.

Returns the relative distinguished name pointed at by the iterator in the global form and forwards the iterator by one element. If the iterator has reached the end of the service instance identifier or the service identifier is NULL, returns an error.

Returns the relative distinguished name pointed at by the iterator in the local form and forwards the iterator by one element. If the iterator has reached the end of the service instance identifier or the service identifier is NULL, returns an error.

21. 
    SLE Credentials
    

Objects implementing this interface hold the credentials used for authentication of the peer identity. The credentials comprise a message digest (the protected), a random number, and the time when the message digest was generated. For the message digest the object does not make any assumptions on the format, size, or encoding. It simply stores the sequence of bytes passed to it.

#include

#include

interface ISLE_Time;

{ 0x9b, 0x44, 0x0, 0xa0, 0x24, 0x6d, 0x80, 0xdb } }

{

virtual long

virtual const SLE_Octet*

Get_Protected( size_t& size ) const = 0;

virtual const ISLE_Time&

Get_TimeRef() const = 0;

virtual void

Set_RandomNumber( long number ) = 0;

virtual void

Set_Protected( const SLE_Octet* hashCode, size_t size ) = 0;

virtual void

Set_TimeRef( const ISLE_Time& time ) = 0;

virtual bool

operator== ( const ISLE_Credentials& credentials ) const = 0;

virtual bool

operator!= ( const ISLE_Credentials& credentials ) const = 0;

virtual ISLE_Credentials*

Copy() const = 0;

virtual char*

Dump() const = 0;

};

Methods

Returns the random number currently stored in the object or zero when no value has been set. Of course, zero is as random as any other number. A return value of zero does not indicate that the attribute has not been set.

Returns the hash code (‘the protected’) currently stored in the object or a NULL pointer when no value has been set.

Returns the generation time stored in the object; if no values have been set, the time value is undefined.

Sets the random number to the value of the input argument.

Sets the hash code in the object copying the input argument.

Sets the generation time in the object copying the input argument.

Comparison operators for credentials.

Performs a deep copy and returns it.

Produces a human readable string of the object contents. The returned value must be deleted by the client.

22. 
    SLE Security Attributes
    

Objects implementing this interface hold the user name and the password required for generating and authenticating credentials. For the password the object does not make any assumptions on the format, size, or encoding. It simply stores the sequence of bytes passed to it.

The interface provides methods to generate credentials and to authenticate credentials. The procedure applied for both methods is specified in 3.5.6.

Because the object stores sensitive information it does not provide methods for read access and does not support printing of the contents.

#include

#include

interface ISLE_Credentials;

{ 0x9b, 0x44, 0x0, 0xa0, 0x24, 0x6d, 0x80, 0xdb } }

{

virtual void

virtual void

Set_Password( const SLE_Octet* pwd, size_t size ) = 0;

virtual void

Set_HexPassword( const char* pwd ) = 0;

virtual ISLE_Credentials*

GenerateCredentials() const = 0;

virtual bool

Authenticate( const ISLE_Credentials& credentials,

int acceptableDelay ) const = 0;

virtual bool

operator== ( const ISLE_SecAttributes& secAttr ) const = 0;

virtual bool

operator!= ( const ISLE_SecAttributes& secAttr ) const = 0;

virtual ISLE_SecAttributes*

Copy() const = 0;

};

Methods

void Set_UserName( const char* name );

Sets the user name to the value defined by the argument.