source: rtems-docs/posix_users/language_specific_services.rst @ 3a71759

4.115
Last change on this file since 3a71759 was 1264a8f, checked in by Amar Takhar <amar@…>, on 01/17/16 at 05:55:21

Split document into seperate files by section.

  • Property mode set to 100644
File size: 8.0 KB
Line 
1Language-Specific Services for the C Programming Language Manager
2#################################################################
3
4Introduction
5============
6
7The
8language-specific services for the C programming language manager is ...
9
10The directives provided by the language-specific services for the C programming language manager are:
11
12- ``setlocale`` - Set the Current Locale
13
14- ``fileno`` - Obtain File Descriptor Number for this File
15
16- ``fdopen`` - Associate Stream with File Descriptor
17
18- ``flockfile`` - Acquire Ownership of File Stream
19
20- ``ftrylockfile`` - Poll to Acquire Ownership of File Stream
21
22- ``funlockfile`` - Release Ownership of File Stream
23
24- ``getc_unlocked`` - Get Character without Locking
25
26- ``getchar_unlocked`` - Get Character from stdin without Locking
27
28- ``putc_unlocked`` - Put Character without Locking
29
30- ``putchar_unlocked`` - Put Character to stdin without Locking
31
32- ``setjmp`` - Save Context for Non-Local Goto
33
34- ``longjmp`` - Non-Local Jump to a Saved Context
35
36- ``sigsetjmp`` - Save Context with Signal Status for Non-Local Goto
37
38- ``siglongjmp`` - Non-Local Jump with Signal Status to a Saved Context
39
40- ``tzset`` - Initialize Time Conversion Information
41
42- ``strtok_r`` - Reentrant Extract Token from String
43
44- ``asctime_r`` - Reentrant struct tm to ASCII Time Conversion
45
46- ``ctime_r`` - Reentrant time_t to ASCII Time Conversion
47
48- ``gmtime_r`` - Reentrant UTC Time Conversion
49
50- ``localtime_r`` - Reentrant Local Time Conversion
51
52- ``rand_r`` - Reentrant Random Number Generation
53
54Background
55==========
56
57There is currently no text in this section.
58
59Operations
60==========
61
62There is currently no text in this section.
63
64Directives
65==========
66
67This section details the language-specific services for the C programming language manager’s directives.
68A subsection is dedicated to each of this manager’s directives
69and describes the calling sequence, related constants, usage,
70and status codes.
71
72setlocale - Set the Current Locale
73----------------------------------
74.. index:: setlocale
75.. index:: set the current locale
76
77**CALLING SEQUENCE:**
78
79.. code:: c
80
81    int setlocale(
82    );
83
84**STATUS CODES:**
85
86*E*
87    The
88
89**DESCRIPTION:**
90
91**NOTES:**
92
93fileno - Obtain File Descriptor Number for this File
94----------------------------------------------------
95.. index:: fileno
96.. index:: obtain file descriptor number for this file
97
98**CALLING SEQUENCE:**
99
100.. code:: c
101
102    int fileno(
103    );
104
105**STATUS CODES:**
106
107*E*
108    The
109
110**DESCRIPTION:**
111
112**NOTES:**
113
114fdopen - Associate Stream with File Descriptor
115----------------------------------------------
116.. index:: fdopen
117.. index:: associate stream with file descriptor
118
119**CALLING SEQUENCE:**
120
121.. code:: c
122
123    int fdopen(
124    );
125
126**STATUS CODES:**
127
128*E*
129    The
130
131**DESCRIPTION:**
132
133**NOTES:**
134
135flockfile - Acquire Ownership of File Stream
136--------------------------------------------
137.. index:: flockfile
138.. index:: acquire ownership of file stream
139
140**CALLING SEQUENCE:**
141
142.. code:: c
143
144    int flockfile(
145    );
146
147**STATUS CODES:**
148
149*E*
150    The
151
152**DESCRIPTION:**
153
154**NOTES:**
155
156ftrylockfile - Poll to Acquire Ownership of File Stream
157-------------------------------------------------------
158.. index:: ftrylockfile
159.. index:: poll to acquire ownership of file stream
160
161**CALLING SEQUENCE:**
162
163.. code:: c
164
165    int ftrylockfile(
166    );
167
168**STATUS CODES:**
169
170*E*
171    The
172
173**DESCRIPTION:**
174
175**NOTES:**
176
177funlockfile - Release Ownership of File Stream
178----------------------------------------------
179.. index:: funlockfile
180.. index:: release ownership of file stream
181
182**CALLING SEQUENCE:**
183
184.. code:: c
185
186    int funlockfile(
187    );
188
189**STATUS CODES:**
190
191*E*
192    The
193
194**DESCRIPTION:**
195
196**NOTES:**
197
198getc_unlocked - Get Character without Locking
199---------------------------------------------
200.. index:: getc_unlocked
201.. index:: get character without locking
202
203**CALLING SEQUENCE:**
204
205.. code:: c
206
207    int getc_unlocked(
208    );
209
210**STATUS CODES:**
211
212*E*
213    The
214
215**DESCRIPTION:**
216
217**NOTES:**
218
219getchar_unlocked - Get Character from stdin without Locking
220-----------------------------------------------------------
221.. index:: getchar_unlocked
222.. index:: get character from stdin without locking
223
224**CALLING SEQUENCE:**
225
226.. code:: c
227
228    int getchar_unlocked(
229    );
230
231**STATUS CODES:**
232
233*E*
234    The
235
236**DESCRIPTION:**
237
238**NOTES:**
239
240putc_unlocked - Put Character without Locking
241---------------------------------------------
242.. index:: putc_unlocked
243.. index:: put character without locking
244
245**CALLING SEQUENCE:**
246
247.. code:: c
248
249    int putc_unlocked(
250    );
251
252**STATUS CODES:**
253
254*E*
255    The
256
257**DESCRIPTION:**
258
259**NOTES:**
260
261putchar_unlocked - Put Character to stdin without Locking
262---------------------------------------------------------
263.. index:: putchar_unlocked
264.. index:: put character to stdin without locking
265
266**CALLING SEQUENCE:**
267
268.. code:: c
269
270    int putchar_unlocked(
271    );
272
273**STATUS CODES:**
274
275*E*
276    The
277
278**DESCRIPTION:**
279
280**NOTES:**
281
282setjmp - Save Context for Non-Local Goto
283----------------------------------------
284.. index:: setjmp
285.. index:: save context for non
286
287**CALLING SEQUENCE:**
288
289.. code:: c
290
291    int setjmp(
292    );
293
294**STATUS CODES:**
295
296*E*
297    The
298
299**DESCRIPTION:**
300
301**NOTES:**
302
303longjmp - Non-Local Jump to a Saved Context
304-------------------------------------------
305.. index:: longjmp
306.. index:: non
307
308**CALLING SEQUENCE:**
309
310.. code:: c
311
312    int longjmp(
313    );
314
315**STATUS CODES:**
316
317*E*
318    The
319
320**DESCRIPTION:**
321
322**NOTES:**
323
324sigsetjmp - Save Context with Signal Status for Non-Local Goto
325--------------------------------------------------------------
326.. index:: sigsetjmp
327.. index:: save context with signal status for non
328
329**CALLING SEQUENCE:**
330
331.. code:: c
332
333    int sigsetjmp(
334    );
335
336**STATUS CODES:**
337
338*E*
339    The
340
341**DESCRIPTION:**
342
343**NOTES:**
344
345siglongjmp - Non-Local Jump with Signal Status to a Saved Context
346-----------------------------------------------------------------
347.. index:: siglongjmp
348.. index:: non
349
350**CALLING SEQUENCE:**
351
352.. code:: c
353
354    int siglongjmp(
355    );
356
357**STATUS CODES:**
358
359*E*
360    The
361
362**DESCRIPTION:**
363
364**NOTES:**
365
366tzset - Initialize Time Conversion Information
367----------------------------------------------
368.. index:: tzset
369.. index:: initialize time conversion information
370
371**CALLING SEQUENCE:**
372
373.. code:: c
374
375    int tzset(
376    );
377
378**STATUS CODES:**
379
380*E*
381    The
382
383**DESCRIPTION:**
384
385**NOTES:**
386
387strtok_r - Reentrant Extract Token from String
388----------------------------------------------
389.. index:: strtok_r
390.. index:: reentrant extract token from string
391
392**CALLING SEQUENCE:**
393
394.. code:: c
395
396    int strtok_r(
397    );
398
399**STATUS CODES:**
400
401*E*
402    The
403
404**DESCRIPTION:**
405
406**NOTES:**
407
408asctime_r - Reentrant struct tm to ASCII Time Conversion
409--------------------------------------------------------
410.. index:: asctime_r
411.. index:: reentrant struct tm to ascii time conversion
412
413**CALLING SEQUENCE:**
414
415.. code:: c
416
417    int asctime_r(
418    );
419
420**STATUS CODES:**
421
422*E*
423    The
424
425**DESCRIPTION:**
426
427**NOTES:**
428
429ctime_r - Reentrant time_t to ASCII Time Conversion
430---------------------------------------------------
431.. index:: ctime_r
432.. index:: reentrant time_t to ascii time conversion
433
434**CALLING SEQUENCE:**
435
436.. code:: c
437
438    int ctime_r(
439    );
440
441**STATUS CODES:**
442
443*E*
444    The
445
446**DESCRIPTION:**
447
448**NOTES:**
449
450gmtime_r - Reentrant UTC Time Conversion
451----------------------------------------
452.. index:: gmtime_r
453.. index:: reentrant utc time conversion
454
455**CALLING SEQUENCE:**
456
457.. code:: c
458
459    int gmtime_r(
460    );
461
462**STATUS CODES:**
463
464*E*
465    The
466
467**DESCRIPTION:**
468
469**NOTES:**
470
471localtime_r - Reentrant Local Time Conversion
472---------------------------------------------
473.. index:: localtime_r
474.. index:: reentrant local time conversion
475
476**CALLING SEQUENCE:**
477
478.. code:: c
479
480    int localtime_r(
481    );
482
483**STATUS CODES:**
484
485*E*
486    The
487
488**DESCRIPTION:**
489
490**NOTES:**
491
492rand_r - Reentrant Random Number Generation
493-------------------------------------------
494.. index:: rand_r
495.. index:: reentrant random number generation
496
497**CALLING SEQUENCE:**
498
499.. code:: c
500
501    int rand_r(
502    );
503
504**STATUS CODES:**
505
506*E*
507    The
508
509**DESCRIPTION:**
510
511**NOTES:**
512
513.. COMMENT: COPYRIGHT (c) 1988-2002.
514
515.. COMMENT: On-Line Applications Research Corporation (OAR).
516
517.. COMMENT: All rights reserved.
518
Note: See TracBrowser for help on using the repository browser.