doc/html/ref/posix-process-environment.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >Process Environment [POSIX Section 4]</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="POSIX Standard Support"
  23 HREF="posix-standard-support.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="POSIX Standard Support"
  26 HREF="posix-standard-support.html"><LINK
  27 REL="NEXT"
  28 TITLE="Files and Directories [POSIX Section 5]"
  29 HREF="posix-files-and-directories.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="posix-standard-support.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 31. POSIX Standard Support</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="posix-files-and-directories.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="POSIX-PROCESS-ENVIRONMENT">Process Environment &#0091;POSIX Section 4&#0093;</H1
  86 ><DIV
  87 CLASS="SECT2"
  88 ><H2
  89 CLASS="SECT2"
  90 ><A
  91 NAME="AEN13011">Functions Implemented</H2
  92 ><TABLE
  93 BORDER="5"
  94 BGCOLOR="#E0E0F0"
  95 WIDTH="70%"
  96 ><TR
  97 ><TD
  98 ><PRE
  99 CLASS="SCREEN"
 100 >int uname( struct utsname &#0042;name );
 101 time&#0095;t time( time&#0095;t &#0042;tloc );
 102 char &#0042;getenv( const char &#0042;name );
 103 int isatty( int fd );
 104 long sysconf( int name );</PRE
 105 ></TD
 106 ></TR
 107 ></TABLE
 108 ></DIV
 109 ><DIV
 110 CLASS="SECT2"
 111 ><H2
 112 CLASS="SECT2"
 113 ><A
 114 NAME="AEN13014">Functions Omitted</H2
 115 ><TABLE
 116 BORDER="5"
 117 BGCOLOR="#E0E0F0"
 118 WIDTH="70%"
 119 ><TR
 120 ><TD
 121 ><PRE
 122 CLASS="SCREEN"
 123 >pid&#0095;t getpid( void );
 124 pid&#0095;t getppid( void );
 125 uid&#0095;t getuid( void );
 126 uid&#0095;t geteuid( void );
 127 gid&#0095;t getgid( void );
 128 gid&#0095;t getegid( void );
 129 int setuid( uid&#0095;t uid );
 130 int setgid( gid&#0095;t gid );
 131 int getgroups( int gidsetsize, gid&#0095;t grouplist&#0091;&#0093; );
 132 char &#0042;getlogin( void );
 133 int getlogin&#0095;r( char &#0042;name, size&#0095;t namesize );
 134 pid&#0095;t getpgrp( void );
 135 pid&#0095;t setsid( void );
 136 int setpgid( pid&#0095;t pid, pid&#0095;t pgid );
 137 char &#0042;ctermid( char &#0042;s);
 138 char &#0042;ttyname( int fd );                             &#0047;&#0047; TBA
 139 int ttyname&#0095;r( int fd, char &#0042;name, size&#0095;t namesize); &#0047;&#0047; TBA
 140 clock&#0095;t times( struct tms &#0042;buffer );                 &#0047;&#0047; TBA</PRE
 141 ></TD
 142 ></TR
 143 ></TABLE
 144 ></DIV
 145 ><DIV
 146 CLASS="SECT2"
 147 ><H2
 148 CLASS="SECT2"
 149 ><A
 150 NAME="AEN13017">Notes</H2
 151 ><P
 152 ></P
 153 ><UL
 154 ><LI
 155 ><P
 156 >The fields of the <SPAN
 157 CLASS="emphasis"
 158 ><I
 159 CLASS="EMPHASIS"
 160 >utsname</I
 161 ></SPAN
 162 >
 163             structure are initialized as follows:
 164             <TABLE
 165 BORDER="5"
 166 BGCOLOR="#E0E0F0"
 167 WIDTH="70%"
 168 ><TR
 169 ><TD
 170 ><PRE
 171 CLASS="SCREEN"
 172 >           sysname     &#8220;eCos&#8221;
 173             nodename    &#8220;&#8221;  (gethostname() is currently not available)
 174
 175             release             Major version number of the kernel
 176             version             Minor version number of the kernel
 177             machine     &#8220;&#8221;  (Requires some config tool changes)
 178             </PRE
 179 ></TD
 180 ></TR
 181 ></TABLE
 182 >
 183             </P
 184 ><P
 185 >           The sizes of these strings are defined by
 186             CYG&#0095;POSIX&#0095;UTSNAME&#0095;LENGTH and
 187             CYG&#0095;POSIX&#0095;UTSNAME&#0095;NODENAME&#0095;LENGTH. The
 188             latter defaults to the value of the former, but may also
 189             be set independently to accommodate a longer node name.
 190             </P
 191 ></LI
 192 ><LI
 193 ><P
 194 >           The <SPAN
 195 CLASS="emphasis"
 196 ><I
 197 CLASS="EMPHASIS"
 198 >time()</I
 199 ></SPAN
 200 > function is currently
 201             implemented in the C library.
 202             </P
 203 ></LI
 204 ><LI
 205 ><P
 206 >A set of environment strings may be defined at configuration
 207             time with the CYGDAT&#0095;LIBC&#0095;DEFAULT&#0095;ENVIRONMENT
 208             option. The application may also define an environment by direct
 209             assignment to the <SPAN
 210 CLASS="strong"
 211 ><B
 212 CLASS="EMPHASIS"
 213 >environ</B
 214 ></SPAN
 215 >
 216             variable.
 217             </P
 218 ></LI
 219 ><LI
 220 ><P
 221 >           At present <SPAN
 222 CLASS="emphasis"
 223 ><I
 224 CLASS="EMPHASIS"
 225 >isatty()</I
 226 ></SPAN
 227 > assumes that
 228             any character device is a tty and that all other devices are not
 229             ttys. Since the only kind of device that eCos currently supports
 230             is serial character devices, this is an adequate
 231             distinction.
 232             </P
 233 ></LI
 234 ><LI
 235 ><P
 236 >           All system variables supported by sysconf will yield a
 237             value. However, those that are irrelevant to eCos will
 238             either return the default minimum defined in
 239             <TT
 240 CLASS="FILENAME"
 241 >&lt;limits.h&gt;</TT
 242 >,
 243             or zero.
 244             </P
 245 ></LI
 246 ></UL
 247 ></DIV
 248 ></DIV
 249 ><DIV
 250 CLASS="NAVFOOTER"
 251 ><HR
 252 ALIGN="LEFT"
 253 WIDTH="100%"><TABLE
 254 SUMMARY="Footer navigation table"
 255 WIDTH="100%"
 256 BORDER="0"
 257 CELLPADDING="0"
 258 CELLSPACING="0"
 259 ><TR
 260 ><TD
 261 WIDTH="33%"
 262 ALIGN="left"
 263 VALIGN="top"
 264 ><A
 265 HREF="posix-standard-support.html"
 266 ACCESSKEY="P"
 267 >Prev</A
 268 ></TD
 269 ><TD
 270 WIDTH="34%"
 271 ALIGN="center"
 272 VALIGN="top"
 273 ><A
 274 HREF="ecos-ref.html"
 275 ACCESSKEY="H"
 276 >Home</A
 277 ></TD
 278 ><TD
 279 WIDTH="33%"
 280 ALIGN="right"
 281 VALIGN="top"
 282 ><A
 283 HREF="posix-files-and-directories.html"
 284 ACCESSKEY="N"
 285 >Next</A
 286 ></TD
 287 ></TR
 288 ><TR
 289 ><TD
 290 WIDTH="33%"
 291 ALIGN="left"
 292 VALIGN="top"
 293 >POSIX Standard Support</TD
 294 ><TD
 295 WIDTH="34%"
 296 ALIGN="center"
 297 VALIGN="top"
 298 ><A
 299 HREF="posix-standard-support.html"
 300 ACCESSKEY="U"
 301 >Up</A
 302 ></TD
 303 ><TD
 304 WIDTH="33%"
 305 ALIGN="right"
 306 VALIGN="top"
 307 >Files and Directories &#0091;POSIX Section 5&#0093;</TD
 308 ></TR
 309 ></TABLE
 310 ></DIV
 311 ></BODY
 312 ></HTML
 313 >