Class: OSErrorHolder

• Inheritance
• Description
• Related information
• Class protocol
  • Signal constants
  • accessing
  • class initialization
  • instance creation
• Instance protocol
  • accessing
  • error reporting
  • others
  • printing
  • private
  • testing

Inheritance:

   Object
   |
   +--OSErrorHolder

Package:

stx:libbasic

Category:

OS-Support

Version:

rev: 1.31 date: 2018/03/12 14:53:45

user: mawalch

file: OSErrorHolder.st directory: libbasic

module: stx stc-classLibrary: libbasic

Author:

Stefan Vogel

Description:

This class represents low level operating system errors.
We do not use error numbers, because there may be different errnos
for the same error on different systems.

[instance variables:]
    errorSymbol             symbol associated with this error
    errorCategory           symbol defining the error category.
                            This is in fact a symbol that returns a
                            Signal when sent to myself.

    While the errorSymbol may be different on different platforms,
    the errorCategories (which refer to the Signals that will be raised)
    are identical.
    You can get an OS independent error message for an error by sending
    #errorCategoryString.

Related information:

    OperatingSystem

Class protocol:

 allocRetrySignal

 badAccessorSignal

 badArgumentsSignal

 classNotRegisteredSignal

 coNotInitializedSignal

 defaultOsErrorSignal

 existingReferentSignal

 illegalOperationSignal

 inaccessibleSignal

 inappropriateOperationSignal

 inappropriateReferentSignal

 invalidArgumentsSignal

return the signal for invalid arguments (e.g. right class, wrong value).

 needRetrySignal

 noAggregationSignal

 noAssociationSignal

 noDataSignal

 noInterfaceSignal

 noMemorySignal

 noPermissionsSignal

 noResourcesSignal

 noVerbsSignal

 nonexistentSignal

return the signal for non existing referents (i.e. device, file etc.).

 notReadySignal

 peerFaultSignal

 rangeErrorSignal

 signalNamed: signalName

 signals

 transferFaultSignal

 transientErrorSignal

 unavailableReferentSignal

 underSpecifiedSignal

 unknownNameSignal

 unpreparedOperationSignal

 unsupportedOperationSignal

 volumeFullSignal

 wrongSubtypeForOperationSignal

 errorSignal

(comment from inherited method)
return the signal used for error/error: - handling

 initializeSignals

init signals etc.

usage example(s):

Signals := nil. self initializeSignals

 setupSignal: aSymbol parent: parentSignal notifier: aString

setup a signal, which can be retrieved by sending aSymbol to self.
Return the new signal

 errorNumber: num errorSymbol: sym errorCategory: typ

 errorSymbol: sym errorCategory: typ

 unsupportedOperation

Instance protocol:

 errorCategory

 errorNumber

 errorNumber: num errorSymbol: sym errorCategory: typ

 errorSymbol

 errorSymbol: sym errorCategory: typ

 parameter

 parameter: something

 reportError

Report an error.

usage example(s):

(OperatingSystem errorHolderForNumber:22) reportError

 reportError: errorMessage

Report an error. Show insert errorMessage into error string.

 reportProceedableError

Report an error.

 reportProceedableError: errorMessage

Report an error. Show insert errorMessage into error string.

 description

 errorString

 printOn: aStream

 makeErrorStringFor: aString

Private: compute an errorString from myself and aString

 isOSErrorHolder