bsd/man/man3/posix_spawnattr_setsigdefault.3

   1 .\"
   2 .\" Copyright (c) 2000-2007 Apple Inc. All rights reserved.
   3 .\"
   4 .\" @APPLE_OSREFERENCE_LICENSE_HEADER_START@
   5 .\"
   6 .\" This file contains Original Code and/or Modifications of Original Code
   7 .\" as defined in and that are subject to the Apple Public Source License
   8 .\" Version 2.0 (the 'License'). You may not use this file except in
   9 .\" compliance with the License. The rights granted to you under the License
  10 .\" may not be used to create, or enable the creation or redistribution of,
  11 .\" unlawful or unlicensed copies of an Apple operating system, or to
  12 .\" circumvent, violate, or enable the circumvention or violation of, any
  13 .\" terms of an Apple operating system software license agreement.
  14 .\"
  15 .\" Please obtain a copy of the License at
  16 .\" http://www.opensource.apple.com/apsl/ and read it before using this file.
  17 .\"
  18 .\" The Original Code and all software distributed under the License are
  19 .\" distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  20 .\" EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  21 .\" INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  22 .\" FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  23 .\" Please see the License for the specific language governing rights and
  24 .\" limitations under the License.
  25 .\"
  26 .\" @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  27 .\"
  28 .\"     @(#)posix_spawnattr_setsigdefault.3
  29 .
  30 .Dd August 22, 2007
  31 .Dt POSIX_SPAWNATTR_SETSIGDEFAULT 3
  32 .Os "Mac OS X"
  33 .Sh NAME
  34 .Nm posix_spawnattr_setsigdefault
  35 .Nm posix_spawnattr_getsigdefault
  36 .Nd set or get the
  37 .Em spawn-sigdefault
  38 attribute on a
  39 .Em posix_spawnattr_t
  40 .Sh SYNOPSIS
  41 .Fd #include <spawn.h>
  42 .Ft int
  43 .Fo posix_spawnattr_setsigdefault
  44 .Fa "posix_spawnattr_t *restrict attr"
  45 .Fa "const sigset_t *restrict sigdefault"
  46 .Fc
  47 .Ft int
  48 .Fo posix_spawnattr_getsigdefault
  49 .Fa "const posix_spawnattr_t *restrict attr"
  50 .Fa "sigset_t *restrict sigdefault"
  51 .Fc
  52 .Sh DESCRIPTION
  53 The
  54 .Fn posix_spawnattr_setsigdefault
  55 function sets the
  56 .Fa sigdefault
  57 on the attributes object referenced by
  58 .Fa attr .
  59 .Pp
  60 The
  61 .Fn posix_spawnattr_getsigdefault
  62 function retrieves the
  63 .Fa sigdefault
  64 on the attributes object referenced by
  65 .Fa attr .
  66 .Pp
  67 The argument
  68 .Fa sigdefault
  69 is the set of signals to be returned to default behaviour in the new
  70 process on creation if the
  71 .Em POSIX_SPAWN_SETSIGDEF
  72 flag is set in the
  73 .Em posix_spawnattr_t .
  74 It's default value must be set via a call to
  75 .Xr posix_spawnattr_setflags 3
  76 or the behaviour is undefined.
  77 .Sh RETURN VALUES
  78 On success, these functions return 0; on failure they return an error
  79 number from
  80 .In errno.h .
  81 Additionally, if successful,
  82 .Fn posix_spawnattr_getsigdefault
  83 will modify the contents of the
  84 .Fa sigdefault
  85 parameter with the current attribute value.
  86 .Sh ERRORS
  87 These functions may fail if:
  88 .Bl -tag -width Er
  89 .\" ==========
  90 .It Bq Er EINVAL
  91 The value specified by
  92 .Fa attr
  93 is invalid.
  94 .\" ==========
  95 .It Bq Er EINVAL
  96 The value of
  97 .Fa attr
  98 is invalid.
  99 .El
 100 .Sh SEE ALSO
 101 .Xr posix_spawn 2 ,
 102 .Xr posix_spawnp 2 ,
 103 .Xr posix_spawnattr_init 3 ,
 104 .Xr posix_spawnattr_destroy 3 ,
 105 .Xr posix_spawnattr_setflags 3
 106 .Sh STANDARDS
 107 .St -susv3 [SPN]
 108 .Sh HISTORY
 109 The
 110 .Fn posix_spawnattr_setsigdefault
 111 and
 112 .Fn posix_spawnattr_getsigdefault
 113 function calls appeared in
 114 .St -susv3 [SPN] .