URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [posix-process-environment.html] - Blame information for rev 588

Go to most recent revision | Details | Compare with Previous | View Log


<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
<!-- This material may be distributed only subject to the terms      -->
<!-- and conditions set forth in the Open Publication License, v1.0  -->
<!-- or later (the latest version is presently available at          -->
<!-- http://www.opencontent.org/openpub/).                           -->
<!-- Distribution of the work or derivative of the work in any       -->
<!-- standard (paper) book form is prohibited unless prior           -->
<!-- permission is obtained from the copyright holder.               -->
<HTML
><HEAD
><TITLE
>Process Environment [POSIX Section 4]</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="eCos Reference Manual"
HREF="ecos-ref.html"><LINK
REL="UP"
TITLE="POSIX Standard Support"
HREF="posix-standard-support.html"><LINK
REL="PREVIOUS"
TITLE="POSIX Standard Support"
HREF="posix-standard-support.html"><LINK
REL="NEXT"
TITLE="Files and Directories [POSIX Section 5]"
HREF="posix-files-and-directories.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>eCos Reference Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="posix-standard-support.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 31. POSIX Standard Support</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="posix-files-and-directories.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="POSIX-PROCESS-ENVIRONMENT">Process Environment &#0091;POSIX Section 4&#0093;</H1
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN13011">Functions Implemented</H2
><TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SCREEN"
>int uname( struct utsname &#0042;name );
time&#0095;t time( time&#0095;t &#0042;tloc );
char &#0042;getenv( const char &#0042;name );
int isatty( int fd );
long sysconf( int name );</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN13014">Functions Omitted</H2
><TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SCREEN"
>pid&#0095;t getpid( void );
pid&#0095;t getppid( void );
uid&#0095;t getuid( void );
uid&#0095;t geteuid( void );
gid&#0095;t getgid( void );
gid&#0095;t getegid( void );
int setuid( uid&#0095;t uid );
int setgid( gid&#0095;t gid );
int getgroups( int gidsetsize, gid&#0095;t grouplist&#0091;&#0093; );
char &#0042;getlogin( void );
int getlogin&#0095;r( char &#0042;name, size&#0095;t namesize );
pid&#0095;t getpgrp( void );
pid&#0095;t setsid( void );
int setpgid( pid&#0095;t pid, pid&#0095;t pgid );
char &#0042;ctermid( char &#0042;s);
char &#0042;ttyname( int fd );                             &#0047;&#0047; TBA
int ttyname&#0095;r( int fd, char &#0042;name, size&#0095;t namesize); &#0047;&#0047; TBA
clock&#0095;t times( struct tms &#0042;buffer );                 &#0047;&#0047; TBA</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN13017">Notes</H2
><P
></P
><UL
><LI
><P
>The fields of the <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>utsname</I
></SPAN
>
            structure are initialized as follows:
            <TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SCREEN"
>           sysname     &#8220;eCos&#8221;
            nodename    &#8220;&#8221;  (gethostname() is currently not available)
 
            release             Major version number of the kernel
            version             Minor version number of the kernel
            machine     &#8220;&#8221;  (Requires some config tool changes)
            </PRE
></TD
></TR
></TABLE
>
            </P
><P
>           The sizes of these strings are defined by
            CYG&#0095;POSIX&#0095;UTSNAME&#0095;LENGTH and
            CYG&#0095;POSIX&#0095;UTSNAME&#0095;NODENAME&#0095;LENGTH. The
            latter defaults to the value of the former, but may also
            be set independently to accommodate a longer node name.
            </P
></LI
><LI
><P
>           The <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>time()</I
></SPAN
> function is currently
            implemented in the C library.
            </P
></LI
><LI
><P
>A set of environment strings may be defined at configuration
            time with the CYGDAT&#0095;LIBC&#0095;DEFAULT&#0095;ENVIRONMENT
            option. The application may also define an environment by direct
            assignment to the <SPAN
CLASS="strong"
><B
CLASS="EMPHASIS"
>environ</B
></SPAN
>
            variable.
            </P
></LI
><LI
><P
>           At present <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>isatty()</I
></SPAN
> assumes that
            any character device is a tty and that all other devices are not
            ttys. Since the only kind of device that eCos currently supports
            is serial character devices, this is an adequate
            distinction.
            </P
></LI
><LI
><P
>           All system variables supported by sysconf will yield a
            value. However, those that are irrelevant to eCos will
            either return the default minimum defined in
            <TT
CLASS="FILENAME"
>&lt;limits.h&gt;</TT
>,
            or zero.
            </P
></LI
></UL
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="posix-standard-support.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ecos-ref.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="posix-files-and-directories.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>POSIX Standard Support</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="posix-standard-support.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Files and Directories &#0091;POSIX Section 5&#0093;</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- 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 [POSIX Section 4]</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 *name );`
101			`time_t time( time_t *tloc );`
102			`char getenv( const char 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_t getpid( void );`
124			`pid_t getppid( void );`
125			`uid_t getuid( void );`
126			`uid_t geteuid( void );`
127			`gid_t getgid( void );`
128			`gid_t getegid( void );`
129			`int setuid( uid_t uid );`
130			`int setgid( gid_t gid );`
131			`int getgroups( int gidsetsize, gid_t grouplist[] );`
132			`char *getlogin( void );`
133			`int getlogin_r( char *name, size_t namesize );`
134			`pid_t getpgrp( void );`
135			`pid_t setsid( void );`
136			`int setpgid( pid_t pid, pid_t pgid );`
137			`char ctermid( char s);`
138			`char *ttyname( int fd ); // TBA`
139			`int ttyname_r( int fd, char *name, size_t namesize); // TBA`
140			`clock_t times( struct tms *buffer ); // 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 “eCos”`
173			`nodename “” (gethostname() is currently not available)`
174
175			`release Major version number of the kernel`
176			`version Minor version number of the kernel`
177			`machine “” (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_POSIX_UTSNAME_LENGTH and`
187			`CYG_POSIX_UTSNAME_NODENAME_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_LIBC_DEFAULT_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			`><limits.h></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 [POSIX Section 5]</TD`
308			`></TR`
309			`></TABLE`
310			`></DIV`
311			`></BODY`
312			`></HTML`
313			`>`

Browse

Tools

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [posix-process-environment.html] - Blame information for rev 588