C.8 Unsupported DECthreads Interface Routines

The following DECthreads interface routines are not implemented and not supported on Windows NT or Windows95:

• cma_attr_set_sched/cma_attr_get_sched

• cma_attr_set_priority/cma_attr_get_priority

• cma_thread_set_sched/cma_thread_get_sched

• cma_thread_set_priority/cma_thread_get_priority

• pthread_attr_setsched/pthread_attr_getsched

• pthread_setscheduler/pthread_getscheduler

• pthread_attr_setprio/pthread_attr_getprio

• pthread_setprio/pthread_getprio

• pthread_attr_getguardsize_np/pthread_attr_setguardsize_ np

If these routines are called by your application (because, for example, you are using the same code base on multiple Digital operating systems), and you do not wish to remove them, then ensure that your code checks these functions' return values for unimplemented/unsupported or catches the unimplemented exception and takes appropriate action. The alternative is to conditionally compile the unsupported routine calls above.

Calling one of the above pthread_* routines will return a -1 and set errno to ENOSYS.

Calling one of the above cma_* routines will raise the cma_e_unimp exception.

The following DECthreads interface routines are not implemented, and do not return errors or generate exceptions. Do not use these routines. They will be fixed in a future release to return errors and generate exceptions.

• cma_attr_get_guardsize/cma_attr_set_guardsize

• cma_attr_set_inherit_sched/cma_attr_get_inherit_sched

• pthread_attr_setinheritsched/pthread_attr_getinheritsched

• cma_stack_check_limit_np

The cma_attr_set_stacksize and pthread_attr_setstacksize interface routines do not change the stacksize of newly created threads. DECthreads threads on NT are created with their stack size set to the same size as the primary thread of the process they are created in. The stack size grows as needed. See the Win32 documentation for CreateThread(). No errors or exceptions are generated as a result of using the cma_attr_set_stacksize and pthread_attr_setstacksize routines. Their corresponding routines cma_attr_get_stacksize and pthread_attr_getstacksize return the values set using cma_attr_set_ stacksize and pthread_attr_setstacksize; but this is not useful since DECthreads threads are not created using the stack size attribute.