eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'OSErrorHolder':

Home

Documentation
www.exept.de
Everywhere
for:
[back]

Class: OSErrorHolder


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:

Signal constants
o  allocRetrySignal

o  badAccessorSignal

o  badArgumentsSignal

o  classNotRegisteredSignal

o  coNotInitializedSignal

o  defaultOsErrorSignal

o  existingReferentSignal

o  illegalOperationSignal

o  inaccessibleSignal

o  inappropriateOperationSignal

o  inappropriateReferentSignal

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

o  needRetrySignal

o  noAggregationSignal

o  noAssociationSignal

o  noDataSignal

o  noInterfaceSignal

o  noMemorySignal

o  noPermissionsSignal

o  noResourcesSignal

o  noVerbsSignal

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

o  notReadySignal

o  peerFaultSignal

o  rangeErrorSignal

o  signalNamed: signalName

o  signals

o  transferFaultSignal

o  transientErrorSignal

o  unavailableReferentSignal

o  underSpecifiedSignal

o  unknownNameSignal

o  unpreparedOperationSignal

o  unsupportedOperationSignal

o  volumeFullSignal

o  wrongSubtypeForOperationSignal

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

class initialization
o  initializeSignals
init signals etc.
usage example(s):
    Signals := nil.
    self initializeSignals

o  setupSignal: aSymbol parent: parentSignal notifier: aString
setup a signal, which can be retrieved by sending aSymbol to self.
Return the new signal

instance creation
o  errorNumber: num errorSymbol: sym errorCategory: typ

o  errorSymbol: sym errorCategory: typ

o  unsupportedOperation


Instance protocol:

accessing
o  errorCategory

o  errorNumber

o  errorNumber: num errorSymbol: sym errorCategory: typ

o  errorSymbol

o  errorSymbol: sym errorCategory: typ

o  parameter

o  parameter: something

error reporting
o  reportError
Report an error.
usage example(s):
      (OperatingSystem errorHolderForNumber:22) reportError

o  reportError: errorMessage
Report an error. Show insert errorMessage into error string.

o  reportProceedableError
Report an error.

o  reportProceedableError: errorMessage
Report an error. Show insert errorMessage into error string.

others
o  description

o  errorString

printing
o  printOn: aStream

private
o  makeErrorStringFor: aString
Private: compute an errorString from myself and aString

testing
o  isOSErrorHolder



ST/X 7.1.0.0; WebServer 1.663 at exept.de:8081; Mon, 19 Nov 2018 21:58:19 GMT