pthread_attr.3 (32eef9aeb1f39a1623cea55da147c89abbd5b9a5) pthread_attr.3 (6f673fd1c07f7ba1355441f7952d0b68882fe4f8)
1.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>.
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice(s), this list of conditions and the following disclaimer as

--- 105 unchanged lines hidden (view full) ---

114The
115.Fn pthread_attr_get*
116functions copy the value of the attribute that corresponds to each function name
117to the location pointed to by the second function parameter.
118.Sh RETURN VALUES
119If successful, these functions return 0.
120Otherwise, an error number is returned to indicate the error.
121.Sh ERRORS
1.\" Copyright (C) 2000 Jason Evans <jasone@FreeBSD.org>.
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice(s), this list of conditions and the following disclaimer as

--- 105 unchanged lines hidden (view full) ---

114The
115.Fn pthread_attr_get*
116functions copy the value of the attribute that corresponds to each function name
117to the location pointed to by the second function parameter.
118.Sh RETURN VALUES
119If successful, these functions return 0.
120Otherwise, an error number is returned to indicate the error.
121.Sh ERRORS
122The
122.Fn pthread_attr_init
123.Fn pthread_attr_init
123will fail if:
124function will fail if:
124.Bl -tag -width Er
125.It Bq Er ENOMEM
126Out of memory.
127.El
128.Pp
125.Bl -tag -width Er
126.It Bq Er ENOMEM
127Out of memory.
128.El
129.Pp
130The
129.Fn pthread_attr_destroy
131.Fn pthread_attr_destroy
130will fail if:
132function will fail if:
131.Bl -tag -width Er
132.It Bq Er EINVAL
133Invalid value for
134.Fa attr .
135.El
136.Pp
133.Bl -tag -width Er
134.It Bq Er EINVAL
135Invalid value for
136.Fa attr .
137.El
138.Pp
139The
137.Fn pthread_attr_setstacksize
140.Fn pthread_attr_setstacksize
138will fail if:
141function will fail if:
139.Bl -tag -width Er
140.It Bq Er EINVAL
141.Fa stacksize
142is less than
143.Dv PTHREAD_STACK_MIN .
144.El
145.Pp
142.Bl -tag -width Er
143.It Bq Er EINVAL
144.Fa stacksize
145is less than
146.Dv PTHREAD_STACK_MIN .
147.El
148.Pp
149The
146.Fn pthread_attr_setdetachstate
150.Fn pthread_attr_setdetachstate
147will fail if:
151function will fail if:
148.Bl -tag -width Er
149.It Bq Er EINVAL
150Invalid value for
151.Fa detachstate .
152.El
153.Pp
152.Bl -tag -width Er
153.It Bq Er EINVAL
154Invalid value for
155.Fa detachstate .
156.El
157.Pp
158The
154.Fn pthread_attr_setinheritsched
159.Fn pthread_attr_setinheritsched
155will fail if:
160function will fail if:
156.Bl -tag -width Er
157.It Bq Er EINVAL
158Invalid value for
159.Fa attr .
160.El
161.Pp
161.Bl -tag -width Er
162.It Bq Er EINVAL
163Invalid value for
164.Fa attr .
165.El
166.Pp
167The
162.Fn pthread_attr_setschedparam
168.Fn pthread_attr_setschedparam
163will fail if:
169function will fail if:
164.Bl -tag -width Er
165.It Bq Er EINVAL
166Invalid value for
167.Fa attr .
168.It Bq Er ENOTSUP
169Invalid value for
170.Fa param .
171.El
172.Pp
170.Bl -tag -width Er
171.It Bq Er EINVAL
172Invalid value for
173.Fa attr .
174.It Bq Er ENOTSUP
175Invalid value for
176.Fa param .
177.El
178.Pp
179The
173.Fn pthread_attr_setschedpolicy
180.Fn pthread_attr_setschedpolicy
174will fail if:
181function will fail if:
175.Bl -tag -width Er
176.It Bq Er EINVAL
177Invalid value for
178.Fa attr .
179.It Bq Er ENOTSUP
180Invalid or unsupported value for
181.Fa policy .
182.El
183.Pp
182.Bl -tag -width Er
183.It Bq Er EINVAL
184Invalid value for
185.Fa attr .
186.It Bq Er ENOTSUP
187Invalid or unsupported value for
188.Fa policy .
189.El
190.Pp
191The
184.Fn pthread_attr_setscope
192.Fn pthread_attr_setscope
185will fail if:
193function will fail if:
186.Bl -tag -width Er
187.It Bq Er EINVAL
188Invalid value for
189.Fa attr .
190.It Bq Er ENOTSUP
191Invalid or unsupported value for
192.Fa contentionscope .
193.El
194.Sh SEE ALSO
195.Xr pthread_create 3
196.Sh STANDARDS
194.Bl -tag -width Er
195.It Bq Er EINVAL
196Invalid value for
197.Fa attr .
198.It Bq Er ENOTSUP
199Invalid or unsupported value for
200.Fa contentionscope .
201.El
202.Sh SEE ALSO
203.Xr pthread_create 3
204.Sh STANDARDS
205The
197.Fn pthread_attr_init ,
198.Fn pthread_attr_destroy ,
199.Fn pthread_attr_setstacksize ,
200.Fn pthread_attr_getstacksize ,
201.Fn pthread_attr_setstackaddr ,
202.Fn pthread_attr_getstackaddr ,
203.Fn pthread_attr_setdetachstate ,
204and
205.Fn pthread_attr_getdetachstate
206.Fn pthread_attr_init ,
207.Fn pthread_attr_destroy ,
208.Fn pthread_attr_setstacksize ,
209.Fn pthread_attr_getstacksize ,
210.Fn pthread_attr_setstackaddr ,
211.Fn pthread_attr_getstackaddr ,
212.Fn pthread_attr_setdetachstate ,
213and
214.Fn pthread_attr_getdetachstate
206conform to
215functions conform to
207.St -p1003.1-96
208.Pp
216.St -p1003.1-96
217.Pp
218The
209.Fn pthread_attr_setinheritsched ,
210.Fn pthread_attr_getinheritsched ,
211.Fn pthread_attr_setschedparam ,
212.Fn pthread_attr_getschedparam ,
213.Fn pthread_attr_setschedpolicy ,
214.Fn pthread_attr_getschedpolicy ,
215.Fn pthread_attr_setscope ,
216and
217.Fn pthread_attr_getscope
219.Fn pthread_attr_setinheritsched ,
220.Fn pthread_attr_getinheritsched ,
221.Fn pthread_attr_setschedparam ,
222.Fn pthread_attr_getschedparam ,
223.Fn pthread_attr_setschedpolicy ,
224.Fn pthread_attr_getschedpolicy ,
225.Fn pthread_attr_setscope ,
226and
227.Fn pthread_attr_getscope
218conform to
228functions conform to
219.St -susv2
229.St -susv2