Class: OSErrorHolder

• Inheritance
• Description
• Related information
• Class protocol
  • Signal constants
  • accessing
  • class initialization
• Instance protocol
  • accessing
  • error reporting
  • others

Inheritance:

   Object
   |
   +--OSErrorHolder

Package:

stx:libbasic

Category:

OS-Support

Version:

rev: 1.17 date: 2009/10/06 08:31:33

user: cg

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

 noAccociationSignal

 noAggregationSignal

 noDataSignal

 noInterfaceSignal

 noMemorySignal

 noPermissionsSignal

 noResourcesSignal

 noVerbsSignal

 nonexistentSignal

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

 notReadySignal

 peerFaultSignal

 rangeErrorSignal

 signalNamed: signalName

 transferFaultSignal

 transientErrorSignal

 unavailableReferentSignal

 underSpecifiedSignal

 unknownNameSignal

 unpreparedOperationSignal

 unsupportedOperationSignal

 volumeFullSignal

 wrongSubtypeForOperationSignal

 errorSignal

 initialize

init signals etc.

 setupSignal: aSymbol parent: parentSignal notifier: aString

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

Instance protocol:

 errorSymbol: sym errorCategory: typ

 parameter

 parameter: something

 reportError

Report an error.

 errorString

 errorSymbol