man pages section 3: Basic Library Functions Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054 U.S.A. Part No: 816–5214–10 December 2002 Copyright 2002 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 U.S.A. All rights reserved. This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Sun, Sun Microsystems, the Sun logo, docs.sun.com, AnswerBook, AnswerBook2, and Solaris are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK and Sun™ Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements. Federal Acquisitions: Commercial Software–Government Users Subject to Standard License Terms and Conditions. DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Copyright 2002 Sun Microsystems, Inc. 4150 Network Circle, Santa Clara, CA 95054 U.S.A. Tous droits réservés Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie, la distribution, et la décompilation. Aucune partie de ce produit ou document ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun. Des parties de ce produit pourront être dérivées du système Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque déposée aux Etats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company, Ltd. Sun, Sun Microsystems, le logo Sun, docs.sun.com, AnswerBook, AnswerBook2, et Solaris sont des marques de fabrique ou des marques déposées, ou marques de service, de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays. Toutes les marques SPARC sont utilisées sous licence et sont des marques de fabrique ou des marques déposées de SPARC International, Inc. aux Etats-Unis et dans d’autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc. L’interface d’utilisation graphique OPEN LOOK et Sun™ a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d’utilisation visuelle ou graphique pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xerox sur l’interface d’utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui en outre se conforment aux licences écrites de Sun. CETTE PUBLICATION EST FOURNIE “EN L’ETAT” ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L’APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU. 021018@4660 Contents Preface 13 Basic Library Functions 19 a64l(3C) 20 abort(3C) 21 abs(3C) 22 addsev(3C) 23 addseverity(3C) 24 assert(3C) 26 atexit(3C) 27 attropen(3C) 28 basename(3C) 29 bsdmalloc(3MALLOC) 30 bsd_signal(3C) 32 bsearch(3C) 33 bstring(3C) 35 btowc(3C) 36 catgets(3C) 37 catopen(3C) 38 cfgetispeed(3C) 41 cfsetispeed(3C) 42 clock(3C) 43 closedir(3C) 44 closefrom(3C) 45 confstr(3C) 47 crypt(3C) 51 3 crypt_genhash_impl(3C) 52 crypt_gensalt(3C) 53 crypt_gensalt_impl(3C) 54 cset(3C) 55 ctermid(3C) 56 ctime(3C) 57 ctype(3C) 62 cuserid(3C) 65 dbm(3UCB) 66 decimal_to_floating(3C) 68 difftime(3C) 70 directio(3C) 71 dirname(3C) 73 div(3C) 75 dladdr(3DL) 76 dlclose(3DL) 78 dldump(3DL) 79 dlerror(3DL) 85 dlinfo(3DL) 86 dlopen(3DL) 90 dlsym(3DL) 94 drand48(3C) 96 dup2(3C) 98 econvert(3C) 99 ecvt(3C) 101 encrypt(3C) 103 end(3C) 104 euclen(3C) 105 exit(3C) 106 fattach(3C) 107 __fbufsize(3C) 109 fclose(3C) 111 fdetach(3C) 113 fdopen(3C) 115 ferror(3C) 117 fflush(3C) 118 ffs(3C) 120 fgetc(3C) 121 4 man pages section 3: Basic Library Functions • December 2002 fgetpos(3C) 124 fgetwc(3C) 125 floating_to_decimal(3C) 127 flock(3UCB) 129 flockfile(3C) 131 fmtmsg(3C) 133 fnmatch(3C) 138 fopen(3C) 140 fopen(3UCB) 143 fpgetround(3C) 145 fputc(3C) 147 fputwc(3C) 150 fputws(3C) 152 fread(3C) 153 freopen(3C) 155 frexp(3C) 157 fseek(3C) 158 fsetpos(3C) 161 fsync(3C) 162 ftell(3C) 164 ftime(3C) 165 ftok(3C) 166 ftw(3C) 168 fwide(3C) 172 fwprintf(3C) 173 fwrite(3C) 180 fwscanf(3C) 181 getcpuid(3C) 188 getcwd(3C) 189 getdate(3C) 191 getdtablesize(3C) 197 getenv(3C) 198 getexecname(3C) 199 getgrnam(3C) 200 gethostid(3C) 204 gethostname(3C) 205 gethrtime(3C) 206 getloadavg(3C) 207 Contents 5 getlogin(3C) 208 getmntent(3C) 210 getnetgrent(3C) 212 getopt(3C) 215 getpagesize(3C) 218 getpagesizes(3C) 219 getpass(3C) 220 getpriority(3C) 221 getpw(3C) 223 getpwnam(3C) 224 getrusage(3C) 228 gets(3C) 231 getspnam(3C) 232 getsubopt(3C) 236 gettext(3C) 239 gettimeofday(3C) 243 gettimeofday(3UCB) 245 gettxt(3C) 246 getusershell(3C) 248 getutent(3C) 249 getutxent(3C) 252 getvfsent(3C) 256 getwc(3C) 258 getwchar(3C) 259 getwd(3C) 260 getwidth(3C) 261 getws(3C) 262 glob(3C) 263 grantpt(3C) 267 hsearch(3C) 268 iconv(3C) 271 iconv_close(3C) 276 iconv_open(3C) 277 index(3C) 279 initgroups(3C) 280 insque(3C) 281 isaexec(3C) 282 isastream(3C) 283 6 man pages section 3: Basic Library Functions • December 2002 isatty(3C) 284 isnan(3C) 285 iswalpha(3C) 287 iswctype(3C) 289 killpg(3C) 291 lckpwdf(3C) 292 ldexp(3C) 293 lfmt(3C) 294 localeconv(3C) 298 lockf(3C) 302 _longjmp(3C) 305 lsearch(3C) 306 madvise(3C) 308 makecontext(3C) 311 makedev(3C) 312 malloc(3C) 313 malloc(3MALLOC) 316 mapmalloc(3MALLOC) 319 mblen(3C) 321 mbrlen(3C) 322 mbrtowc(3C) 324 mbsinit(3C) 326 mbsrtowcs(3C) 327 mbstowcs(3C) 329 mbtowc(3C) 330 mctl(3UCB) 331 memory(3C) 333 mkfifo(3C) 335 mkstemp(3C) 337 mktemp(3C) 338 mktime(3C) 339 mlock(3C) 342 mlockall(3C) 344 modf(3C) 346 monitor(3C) 347 msync(3C) 349 mtmalloc(3MALLOC) 351 ndbm(3C) 354 Contents 7 nice(3UCB) 358 nlist(3UCB) 359 nl_langinfo(3C) 360 offsetof(3C) 361 opendir(3C) 362 perror(3C) 364 pfmt(3C) 365 plock(3C) 368 popen(3C) 369 printf(3C) 371 printf(3UCB) 380 pset_getloadavg(3C) 384 psignal(3C) 385 psignal(3UCB) 386 pthread_atfork(3C) 387 ptsname(3C) 389 putenv(3C) 390 putpwent(3C) 391 puts(3C) 392 putspent(3C) 393 putws(3C) 394 qsort(3C) 395 raise(3C) 397 rand(3C) 398 rand(3UCB) 399 random(3C) 400 rctlblk_set_value(3C) 403 rctl_walk(3C) 407 readdir(3C) 409 readdir(3UCB) 413 realpath(3C) 415 reboot(3C) 417 re_comp(3C) 418 regcmp(3C) 419 regcomp(3C) 421 remove(3C) 427 rewind(3C) 428 rewinddir(3C) 429 8 man pages section 3: Basic Library Functions • December 2002 scandir(3UCB) 430 scanf(3C) 431 seekdir(3C) 438 select(3C) 439 setbuf(3C) 443 setbuffer(3C) 445 setcat(3C) 446 setjmp(3C) 447 setjmp(3UCB) 450 setkey(3C) 453 setlabel(3C) 454 setlocale(3C) 455 sigblock(3UCB) 458 sigfpe(3C) 459 siginterrupt(3UCB) 461 signal(3C) 462 signal(3UCB) 464 sigsetops(3C) 466 sigstack(3C) 468 sigstack(3UCB) 470 sigvec(3UCB) 471 sleep(3C) 476 sleep(3UCB) 477 ssignal(3C) 478 stdio(3C) 479 str2sig(3C) 483 strcoll(3C) 484 strerror(3C) 485 strfmon(3C) 486 strftime(3C) 490 string(3C) 495 string_to_decimal(3C) 499 strptime(3C) 502 strsignal(3C) 507 strtod(3C) 508 strtol(3C) 511 strtoul(3C) 514 strtows(3C) 516 Contents 9 strxfrm(3C) 517 swab(3C) 519 sync_instruction_memory(3C) 520 syscall(3UCB) 521 sysconf(3C) 522 syslog(3C) 529 system(3C) 533 tcdrain(3C) 534 tcflow(3C) 535 tcflush(3C) 536 tcgetattr(3C) 537 tcgetpgrp(3C) 538 tcgetsid(3C) 539 tcsendbreak(3C) 540 tcsetattr(3C) 541 tcsetpgrp(3C) 543 tell(3C) 544 telldir(3C) 545 termios(3C) 546 times(3UCB) 547 tmpfile(3C) 548 tmpnam(3C) 549 toascii(3C) 551 _tolower(3C) 552 tolower(3C) 553 _toupper(3C) 554 toupper(3C) 555 towctrans(3C) 556 towlower(3C) 557 towupper(3C) 558 truncate(3C) 559 tsearch(3C) 562 ttyname(3C) 565 ttyslot(3C) 567 ualarm(3C) 568 ungetc(3C) 569 ungetwc(3C) 570 unlockpt(3C) 571