Errata for PThreads Programming

The FTP section has been updated so that it now reads: "%ftp ftp.oreilly.com Connected to ftp.oreilly.com. 220 FTP server (Version 6.21 Tue Mar 10 22:09:55 EST 1992) ready. Name (ftp.oreilly.com:yourname) : anonymous 331 Guest login ok, send domain style e-mail address as password. Password: yourname@domain.name (use your user name and host here) 230 Guest login ok, access restrictions apply. ftp> cd /work/nutshell/9781565921153 250 CWD command successful. ftp> binary (Very important! You must specify binary transfer for compressed files.) 200 Type set to I. ftp> get examples.tar.gz 200 PORT command successful. 150 Opening BINARY mode data connection for examples.tar.gz 226 Transfer complete. ftp> quit 221 Goodbye. % The file is a gzip compressed tar archive; extract the files from the archive by typing: % gzcat examples.tar.gz | tar xvf - System V systems require the following tar command instead: % gzcat examples.tar.gz | tar xof - If gzcat is not available on your system, use separate gunzip and tar or shar commands. % gunzip examples.tar.gz % tar xvf examples.tar"

#include <stdio.h> line added before "main": extern int and: changed "main()" to "main(void)"

return 0;

column changed from "do one_thing" to "do another_thing"

#include <stdlib.h> #include <stdio.h> #include <unistd.h> replaced blank line 4 with: #include <sys/wait.h>

extern int and: changed "main()" to "main(void)" and: in line after "/*initialize shared...": changed "0" to "0660"; in two lines that read "exit()", inserted a "0" between the parens; in the two "waitpid" lines, added "&" before "status"; changed blank next-to-last line to read: return 0;

parens after "exit"; changed line 12 ("exit()") to read "return 0;"

#include <stdio.h> line added before "main": extern int and: changed "main()" to "main(void)"

changed blank next-to-last line to read: return 0; also added a paragraph after the last one: The formal prototype of a start routine is (void*)routine(void*arg). In our code example, we are adding threads to an existing program (a not atypical scenario) and using the (void *) cast to quit the compiler. In later examples, we redeclare the routine to the correct prototype where possible.

#include <stdio.h> line added before "main(int argc...": extern int and changed blank next-to-last line to: return 0;

extern int and: changed "main()" to "main(void)"; changed line "routine_x()" to: void routine_x(void)

At the top of the code example, internal_error is declared but not used. static const int internal_error = -12; should be: static const int real_bad_error = -12;

#include <stdio.h> #include <9781565921153.h> line added before "main(int argc...": extern int

return 0; in example 1-9, changed "exit(-1)" to "exit(1)" (line -6)

1-9 on this page

extern int

return 0;

extern int and added a line after "server_comm....": return 0

extern int and: changed "main()" to "main(void)"; tabbed line "mult(size, row..." to be under "(column" in the line above; added next-to-last line: return 0

extern int and: changed "main()" to "main(void)

next-to-last para, line -2: added a space between "main" (in itals) and "routine"

free(p); to free(work_orderp);

semicolon after "index" to a comma

of p.72 and top of p.73 changed from constant-width font to constant-width italic font

"index" to a comma

changed last line to "return 0;" and aligned the r with the p in "9781565921153" above

#include <stdlib.h> #include <stdio.h> #include <unistd.h> #include <string.h> added to end of #includes: #include <sys/wait.h> added before "int shared...": #ifndef _POSIX_THREAD_PROCESS_SHARED #error "This platform does not support process shared mutex" #endif line added before "main()": extern int and: changed "main()" to "main(void); also, 5 lines below that ("shared_mem_id..."): changed "0" to "0660"

added line to beginning of 3-7: #include <stdio.h> line added before "main()": extern int and: changed "main()" to "main(void)"; 8 lines below that: moved the "}" to align with "for" two lines above, and changed the blank line after the close curly bracket to read: return 0;

{ 9781565921153_t threads[3]; added a new line { init i; 9781565921153_t threads[3]; and changed line 17 from 9781565921153_join(&thread[i], NULL); to 9781565921153_join(thread[i], NULL);

"inc_count" (in italics) and Example 3-7, line 12: changed from init i; to int i;

Example 3-7 used to read: "main(void)" { 9781565921153_t threads[3]; ... 9781565921153_join(&threads[i], NULL);" It now reads: "main(void) { int i; 9781565921153_t threads[3]; ... 9781565921153_join(threads[i], NULL);"

Line 7 of example 3-9 on page 86 used to read: "} 9781565921153_rdwr_t" as the structure for a reader/writer mutex lock. The five function signatures at the top of page 87 appear to use this correctly. However, in the function definitions on page 88-89 in Examples 3-11, 3-12, and 3-13 accept as a first parameter a variable of type: "9781565921153_rdwr_t_np" which contradicts the aforementioned signatures.

Example 3-11 used to read: "int 9781565921153_rdwr_rlock_np(pthread_rdwr_t_np *rdwr) ... 9781565921153_cond_wait(?.) ..." Now reads: "int 9781565921153_rdwr_rlock_np(pthread_rdwr_t *rdwrp) ... 9781565921153_cond_wait(?.); ..."

Example 3-12 used to read: "int 9781565921153_rdwr_wlock_np(pthread_rdwr_t_np *rdwrp) ... 9781565921153_cond_wait(?.) ..." Now reads: "int 9781565921153_rdwr_wlock_np(pthread_rdwr_t *rdwrp) ... 9781565921153_cond_wait(?.); ..."

Example 3-13 did read: "int 9781565921153_rdwr_runlock_np(pthread_rdwr_t_np *rdwrp)" Now reads: "int 9781565921153_rdwr_runlock_np(pthread_rdwr_t *rdwrp)"

rdwrp->wrinter_writing == 0 to rdwrp->wrinter_writing = 0

Example 3-14 used to read: "int 9781565921153_rdwr_wunlock_np(pthread_rdwr_t_np *rdwrp) ... } else { rdwrp->writer_writing == 0; ..." It now reads: "int 9781565921153_rdwr_wunlock_np(pthread_rdwr_t *rdwrp) ... } else { rdwrp->writer_writing = 0; ..."

3-18: changed line 3 to read: extern int and added a line before the final }: return 0;

extern int and added a line before the final }: return 0;

bottom: changed "9781565921153_cond_signal" to "pthread_cond_broadcast"

return 0;

extern int

return 0;

worker_threadp = (9781565921153_t *)malloc(sizeof(pthread_t)); tpool_add_work(atm_thread_pool, process_request, (void *)workorderp);

The second bulleted item used to read: "_POSIX_THREAD_ATTR_PRIORITY_SCHEDULING compile ..." It now reads: "_POSIX_THREAD_PRIORITY_SCHEDULING compile ..."

#ifdef _POSIX_THREAD_ATTR_STACKSIZE 3 lines below that: changed "If" to "if"; added a final line: #endif

. 9781565921153_attr_init (&custom_attr); .

changed line 3 of 4-11 to read: int init_comm(void) and line -4 to read: void free_conn(int *connp)

(124 reprinted for pagebreak.)

#include <stdlib.h> #include <stdio.h> #include <unistd.h> #include <sys.types.h> #include <9781565921153.h> line added before "main()": extern int and: changed "main()" to "main(void)"

"i"; changed blank line -3 to "}" aligned above "printf"; added a line below "printf...": return 0;

"state" to "type"; 6th line from end of example: added "%d" before " "

"&custom_sched_attr"

extern int and: changed "server main()" to "main(void)"

return 0;

high_prio = sched_get_priority_max(SCHED_FIFO);

The priority passed is an integer argument set up in the same manner as a thread's priority value.

. . . }

extern int and: changed "main()" to "main(void)"

lines from "sigwait..." to "9781565921153_mutex_unlock..."; added a new next-to-last line: return NULL;

next-to-last line: return (NULL);

and 17; in line 14, changed "[j+l]" to "[j]"

also, in the next-to-last text para., changed both instances of "9781565921153_test_cancel" to "pthread_testcancel"

10

front on a line by itself, moved that back to align with the other "*"s above. The same goes for "estring[20];" on p. 238; also, on 239, in A-2: changed blank line 4 to: extern int

return 0;

"Syntax: In draft 4 a constant 9781565921153_attr_default is defined that can be used as the second argument in the 9781565921153_create routine when you want the default attributes for a thread. In the final standard the constant no longer exists and if you want default attributes you pass NULL."