Guide to DECthreads

Index

• Address exceptions
• Addressing
  • 64-bit
  • 64-bit, for DECthreads
• Application programming interface (API)
  • error conditions from
• ASTs (asynchronous system traps)
  • delivery of
  • delivery of, with DECthreads
  • restrictions on use
  • restrictions on use with DECthreads
• Asynchronous cancelation
  • of threads
    • cleanup from
• Asynchronous programming techniques
  • in a multithreaded program
• Asynchronous system traps
  • See ASTs
• Attributes
  • of condition variables
  • of mutexes
  • of threads
    • guard size
    • inherit scheduling
    • scheduling policy
    • scheduling priority
    • stack size
• Attributes objects
  • creating
  • destroying

• Background scheduling policy
  • of threads
• Boss/worker functional model
  • work queue variation
• Bugchecks
  • from DECthreads
    • contents of dump file
    • interpreting

• Cancelability
  • of threads
• Cancelability state attribute
  • of threads
    • setting #1
    • setting #2
• Cancelability type attribute
  • of threads
    • setting
• Cancelation points
  • in DECthreads under OpenVMS Alpha
  • routines
    • under Digital UNIX
    • under OpenVMS Alpha
• Cancelation requests
  • delivering
  • delivery of #1
  • delivery of #2
  • requesting delivery of #1
  • requesting delivery of #2
  • sending
• CATCH macro
• CATCH_ALL macro #1
• CATCH_ALL macro #2
• Cleanup handlers
  • establishing
  • executing
  • of threads
• cma interface
• Condition handlers
  • declaring
  • declaring for DECthreads
• Condition values
  • used by DECthreads
• Condition variable attributes objects
  • creating
  • destroying
  • initializing
• Condition variables
  • creating #1
  • creating #2
  • destroying #1
  • destroying #2
  • distinguishing from mutexes
  • in DECthreads tis interface
  • initializing #1
  • initializing #2
  • signaling
  • tis
  • using in thread-safe library code
  • waiting for a specified time interval
  • waiting indefinitely for #1
  • waiting indefinitely for #2

• d4 interface
• Data
  • See thread-specific data
• Deadlocks #1
• Deadlocks #2
  • among threads
  • avoiding
• Debugging tools
  • DECthreads debugger commands
  • for DECthreads applications
  • metered mode
  • pthread_debug() routine
  • pthread_debug_cmd() routine
  • under OpenVMS
  • using Ladebug debugger
  • WinDbg debugger
• DECthreads
  • 64-bit addressing
  • blocking OpenVMS system services
  • blocking system services
  • cancelability of system services #1
  • cancelability of system services #2
  • cancelability of system services #3
  • compiling applications
    • under Windows 95
    • under Windows NT
  • compiling under OpenVMS
  • condition values used
  • considerations
    • for Digital UNIX
    • for OpenVMS
    • for Windows 95
    • for Windows NT
  • DCL command operation
  • debugger tool
  • debugging applications
  • declaring condition handlers
  • delivery of ASTs
  • dynamic activation
    • under Digital UNIX
    • under OpenVMS
  • FAT file naming support
  • header files
    • under Digital UNIX
    • under OpenVMS
  • image exit
  • image exit under OpenVMS
  • interactions with OpenVMS
  • interfaces
    • in C language
    • in languages other than C
  • internal error conditions
  • interoperability with the POSIX for OpenVMS layered product
  • interoperability with Win32 API
  • libraries
  • linking applications
    • under Digital UNIX
    • under Windows 95
    • under Windows NT
  • linking with shared libraries
  • obsolete interfaces
  • pthread interface #1
  • pthread interface #2
  • real-time scheduling
  • tis interface #1
  • tis interface #2
  • tis interface features
  • two-level scheduling #1
  • two-level scheduling #2
    • under Digital UNIX
    • under OpenVMS Alpha
  • undocumented but supported interfaces
  • use of kernel threads
    • under Digital UNIX
    • under OpenVMS Alpha
  • virtual processors
• Detachstate attribute
  • of threads
    • getting
    • setting
• Digital-proprietary CMA (cma) interface
• Digital UNIX operating system
  • using DECthreads with
• Dynamic activation
  • of DECthreads under Digital UNIX
  • of DECthreads under OpenVMS
• Dynamic memory
  • using from threads

• Error conditions
  • from application programming interface (API)
  • internal to DECthreads
  • reporting
• Errorcheck mutexes
• Event flags
• Examples
  • programs
    • prime number search
• Exception objects
  • operations on
  • THIS_CATCH
• Exceptions
  • address
  • CATCH macro
  • catching
    • all
    • specific
  • CATCH_ALL macro
  • debugging
  • declaring and initializing
  • defining a region of code to catch
  • defining epilogue actions
  • determining current
  • exporting error status
  • failing
    • due to condition handlers
  • FINALLY macro #1
  • FINALLY macro #2
  • importing error status
  • matching
  • naming convention for
  • overview of
  • pthread_exc_get_status_np() routine
  • pthread_exc_matches_np() routine
  • pthread_exc_report_np() routine
  • pthread_exc_set_status_np() routine
  • raising
  • reporting
  • RERAISE macro #1
  • RERAISE macro #2
  • RERAISE macro #3
  • reraising
  • role in DECthreads
  • rules for modular use
  • signals reported as
  • status
  • table of DECthreads pthread exceptions and meanings
  • table of pthread exceptions and meanings
  • TRY macro
  • types of
  • unhandled
• Expiration time
  • obtaining

• FAT (File Allocation Table) file system
  • DECthreads file naming support
• FIFO (first-in/first-out) scheduling policy
  • of threads
• FINALLY macro #1
• FINALLY macro #2
• Foreground scheduling policy
  • of threads
• Fork handlers

• $GETJPI system service
  • MULTITHREAD item code
• Global lock
  • using from the tis interface
  • using, to avoid software that lacks thread safety
• Global mutex
  • locking #1
  • locking #2
  • unlocking #1
  • unlocking #2
• Guardsize attribute
  • of threads
    • getting
    • setting

• Handlers
  • cleanup
  • cleanup for threads
  • condition
  • fork
  • interrupt
• Header files
  • DECthreads
• $HIBER system service

• Images
  • compiling DECthreads-based
  • linking DECthreads-based, for OpenVMS
• Inherit scheduling attribute
  • of threads
    • getting
    • setting
• Interfaces
  • to DECthreads
    • cma
    • d4
    • in C language
    • in languages other than C
    • obsolete
    • pthread
    • tis #1
    • tis #2
    • undocumented but supported
• Interrupt handlers
  • for threads

• Kernel threads
  • enabling in existing images
  • OpenVMS linker options
  • under Digital UNIX
  • under OpenVMS Alpha
  • use with DECthreads #1
  • use with DECthreads #2
  • using $GETJPI system service
  • virtual processors and

• Ladebug debugger
  • for DECthreads applications
• Libraries
  • for DECthreads
  • lacking thread safety #1
  • lacking thread safety #2
  • shared
    • linking with DECthreads
    • using with DECthreads
  • thread safety #1
  • thread safety #2
• Locks
  • global, See also Global lock
  • readers/writer

• Macros
  • CATCH
  • CATCH_ALL
  • FINALLY #1
  • FINALLY #2
  • RERAISE #1
  • RERAISE #2
  • TRY
    • restrictions
• Memory
  • dynamic
  • protecting, from thread's stack
  • setting size of thread's stack
  • stack
  • static
  • synchronizing threads' access to
• Multithreaded programming
  • asynchronous programming techniques
  • avoiding use of signals
  • cancelation points
  • debugging tools #1
  • debugging tools #2
  • dependencies upon other libraries
  • dependencies upon other libraries
    • lacking thread safety
    • thread reentrancy
    • thread safety
  • designing for asynchronous execution
  • functional models
    • boss/worker
    • combinations
    • pipelining
    • work crew
  • managing a thread's stack
  • multiple thread libraries unsupported
  • one-time initialization of threads #1
  • one-time initialization of threads #2
  • one-time initialization of threads #3
  • potential issues
    • deadlocks
    • dependence upon nonreentrant software
    • priority inversion
    • program complexity
    • race conditions
  • programming errors
    • initializing DECthreads objects after thread creation
    • passing stack local data
    • using scheduling to accomplish synchronization
  • reporting DECthreads error conditions
  • scheduling of threads
    • priority inversion
    • real-time
  • synchronizing access to memory
  • using dynamic memory
  • using shared memory
  • using stack memory
  • using static memory
  • using synchronization objects
    • avoiding deadlocks
    • avoiding race conditions
    • signaling a condition variable
    • using the appropriate object
  • writing thread-safe libraries
• Mutex attributes objects
  • creating
  • destroying
  • initializing
• Mutexes
  • around call to unsafe code
  • creating #1
  • creating #2
  • destroying #1
  • destroying #2
  • distinguishing from condition variables
  • errorcheck
  • global
    • locking #1
    • locking #2
    • unlocking #1
    • unlocking #2
  • in DECthreads tis interface
  • initializing #1
  • initializing #2
  • locking #1
  • locking #2
  • locking #3
  • locking #4
  • locking before signaling a condition variable
  • mutex type attribute
    • getting
    • setting
  • normal
  • operations on
  • recursive
  • tis
  • types of
  • unlocking #1
  • unlocking #2
  • using in thread-safe library code
  • using static data before release of

  6493PIDX.HTM
  OSSG Documentation
  22-NOV-1996 13:20:29.05

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal