share/man/man3head/types.h.3head

   1 '\" te
   2 .\" Copyright 1989 AT&T.  Copyright (c) 2004, Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH TYPES.H 3HEAD "Oct 6, 2004"
   7 .SH NAME
   8 types.h, types \- primitive system data types
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB#include <sys/types.h>\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The data types defined in <\fBsys/types.h\fR> are as follows:
  19 .SS "32-bit Solaris"
  20 .sp
  21 .LP
  22 The data types listed below are defined in <\fBsys/types.h\fR> for 32-bit
  23 Solaris.
  24 .sp
  25 .in +2
  26 .nf
  27 typedef    struct    { int r[1]; } *physadr;
  28 typedef    long              clock_t;
  29 typedef    long              daddr_t;
  30 typedef    char *            caddr_t;
  31 typedef    unsigned char     unchar;
  32 typedef    unsigned short    ushort;
  33 typedef    unsigned int      uint;
  34 typedef    unsigned long     ulong_t;
  35 typedef    unsigned long     ino_t;
  36 typedef    long              uid_t;
  37 typedef    long              gid_t;
  38 typedef    ulong_t           nlink_t;
  39 typedef    ulong_t           mode_t;
  40 typedef    short             cnt_t;
  41 typedef    long              time_t;
  42 typedef    int               label_t[10];
  43 typedef    ulong_t           dev_t;
  44 typedef    long              off_t;
  45 typedef    long              pid_t;
  46 typedef    long              paddr_t;
  47 typedef    int               key_t;
  48 typedef    unsigned char     use_t;
  49 typedef    short             sysid_t;
  50 typedef    short             index_t;
  51 typedef    short             lock_t;
  52 typedef    unsigned int      size_t;
  53 typedef    long              clock_t;
  54 typedef    long              pid_t;
  55 .fi
  56 .in -2
  57
  58 .SS "64-bit Solaris"
  59 .sp
  60 .LP
  61 The data types listed below are defined in <\fBsys/types.h\fR> for 64-bit
  62 Solaris.
  63 .sp
  64 .in +2
  65 .nf
  66 typedef     long        blkcnt_t
  67 typedef     long        clock_t
  68 typedef     long        daddr_t
  69 typedef     ulong_t     dev_t
  70 typedef     ulong_t     fsblkcnt_t
  71 typedef     ulong_t     fsfilcnt_t
  72 typedef     int         gid_t
  73 typedef     int         id_t
  74 typedef     long        ino_t
  75 typedef     int         key_t
  76 typedef     uint_t      major_t
  77 typedef     uint_t      minor_t
  78 typedef     uint_t      mode_t
  79 typedef     uint_t      nlink_t
  80 typedef     int         pid_t
  81 typedef     ptrdiff_t   intptr_t
  82 typedef     ulong_t     rlim_t
  83 typedef     ulong_t     size_t
  84 typedef     uint_t      speed_t
  85 typedef     long        ssize_t
  86 typedef     long        suseconds_t
  87 typedef     uint_t      tcflag_t
  88 typedef     long        time_t
  89 typedef     int         uid_t
  90 typedef     int         wchar_t
  91 .fi
  92 .in -2
  93
  94 .SS "Preprocessor Symbols"
  95 .sp
  96 .LP
  97 For 32-bit programs, pointers and the C data types \fBint\fR and \fBlong\fR are
  98 all 32-bit quantities.  For 64-bit programs, pointers and the C data type
  99 \fBlong\fR are defined as 64-bit quantities.
 100 .sp
 101 .LP
 102 The preprocessor symbol \fB_ILP32\fR, made visible by the inclusion of
 103 <\fBsys/types.h\fR>, can be used with the preprocessor \fB#ifdef\fR construct
 104 to define sections of code that will be compiled only as part of a 32-bit
 105 version of a given C program.
 106 .sp
 107 .LP
 108 The preprocessor symbol \fB_LP64\fR can be used in the same way to define
 109 sections of code that will be compiled only as part of a 64-bit version of a
 110 given C program. See EXAMPLES.
 111 .sp
 112 .LP
 113 This header incorporates definitions of other preprocessor symbols that can be
 114 useful when keeping code portable between different instruction set
 115 architectures.
 116 .sp
 117 .ne 2
 118 .na
 119 \fB\fB_LITTLE_ENDIAN\fR\fR
 120 .ad
 121 .br
 122 .na
 123 \fB\fB_BIG_ENDIAN\fR\fR
 124 .ad
 125 .RS 27n
 126 The natural byte order of the processor.  A pointer to an \fBint\fR points to
 127 the least/most significant byte of that \fBint\fR.
 128 .RE
 129
 130 .sp
 131 .ne 2
 132 .na
 133 \fB\fB_STACK_GROWS_UPWARD\fR\fR
 134 .ad
 135 .br
 136 .na
 137 \fB\fB_STACK_GROWS_DOWNWARD\fR\fR
 138 .ad
 139 .RS 27n
 140 The processor specific direction of stack growth. A push onto the stack
 141 increases/decreases the stack pointer, so it stores data at successively
 142 higher/lower addresses.
 143 .RE
 144
 145 .sp
 146 .ne 2
 147 .na
 148 \fB\fB_CHAR_IS_UNSIGNED\fR\fR
 149 .ad
 150 .br
 151 .na
 152 \fB\fB_CHAR_IS_SIGNED\fR\fR
 153 .ad
 154 .RS 27n
 155 The C Compiler implements objects of type \fBchar\fR as \fBunsigned\fR or
 156 \fBsigned\fR respectively. This is really an implementation choice of the
 157 compiler, but it is specified in the ABI and tends to be uniform across
 158 compilers for an instruction set architecture.
 159 .RE
 160
 161 .sp
 162 .ne 2
 163 .na
 164 \fB\fB_CHAR_ALIGNMENT\fR\fR
 165 .ad
 166 .br
 167 .na
 168 \fB\fB_SHORT_ALIGNMENT\fR\fR
 169 .ad
 170 .br
 171 .na
 172 \fB\fB_INT_ALIGNMENT\fR\fR
 173 .ad
 174 .br
 175 .na
 176 \fB\fB_LONG_ALIGNMENT\fR\fR
 177 .ad
 178 .br
 179 .na
 180 \fB\fB_LONG_LONG_ALIGNMENT\fR\fR
 181 .ad
 182 .br
 183 .na
 184 \fB\fB_DOUBLE_ALIGNMENT\fR\fR
 185 .ad
 186 .br
 187 .na
 188 \fB\fB_LONG_DOUBLE_ALIGNMENT\fR\fR
 189 .ad
 190 .br
 191 .na
 192 \fB\fB_POINTER_ALIGNMENT\fR\fR
 193 .ad
 194 .br
 195 .na
 196 \fB\fB_FLOAT_ALIGNMENT\fR\fR
 197 .ad
 198 .RS 27n
 199 The ABI defines alignment requirements of each of the primitive object types.
 200 Some, if not all, might be hardware requirements as well. The values are
 201 expressed in bytes.
 202 .RE
 203
 204 .sp
 205 .ne 2
 206 .na
 207 \fB\fB_MAX_ALIGNMENT\fR\fR
 208 .ad
 209 .RS 27n
 210 The most stringent alignment requirement as specified by the ABI. Equal to the
 211 maximum of all the above _\fIXXX\fR_\fBALIGNMENT\fR values.
 212 .RE
 213
 214 .sp
 215 .ne 2
 216 .na
 217 \fB\fB_LONG_LONG_ALIGNMENT_32\fR\fR
 218 .ad
 219 .RS 27n
 220 The 32-bit ABI supported by a 64-bit kernel may have different alignment
 221 requirements for primitive object types. The value of this identifier is
 222 expressed in bytes.
 223 .RE
 224
 225 .SH USAGE
 226 .sp
 227 .LP
 228 The \fBdaddr_t\fR type is used for disk addresses except in an inode on disk.
 229 Times are encoded in seconds since 00:00:00 UTC, January 1, 1970. The major and
 230 minor parts of a device code specify kind and unit number of a device and are
 231 installation-dependent. Offsets are measured in bytes from the beginning of a
 232 file.
 233 .sp
 234 .LP
 235 The \fBlabel_t[\|]\fR types are used to save the processor state while another
 236 process is running.
 237 .SH EXAMPLES
 238 .LP
 239 \fBExample 1 \fRUse of preprocessor symbol \fB_LP64\fR.
 240 .sp
 241 .LP
 242 In the following example, the preprocessor symbol \fB_LP64\fR defines sections
 243 of code that will be compiled only as part of a 64-bit version of the given C
 244 program.
 245
 246 .sp
 247 .in +2
 248 .nf
 249 #include <sys/types.h>
 250 \&...
 251
 252 #ifdef _LP64
 253         printf("The data model is LP64 in this environment\en");
 254 #else
 255 #ifdef _ILP32
 256         printf("The data model is ILP32 in this environment\en");
 257 #else
 258 #error "Unknown data model!"
 259 #endif
 260 #endif
 261 .fi
 262 .in -2
 263
 264 .SH ATTRIBUTES
 265 .sp
 266 .LP
 267 See \fBattributes\fR(5) for descriptions of the following attributes:
 268 .sp
 269
 270 .sp
 271 .TS
 272 box;
 273 c | c
 274 l | l .
 275 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 276 _
 277 Interface Stability     Stable
 278 .TE
 279
 280 .SH SEE ALSO
 281 .sp
 282 .LP
 283 \fBtypes32.h\fR(3HEAD), \fBattributes\fR(5), \fBstandards\fR(5)