c library reference - qnxfusion.qnx.com/0/11960/nto_lib_ref.pdf?tid=2704107_bo_0611030107&... ·...

C LIBRARY REFERENCE

Q N X N E U T R I N O R T O S V 6 .3

QNX Neutrino Realtime

Operating SystemLibrary Reference A to E

For QNX Neutrino 6.3

2005, QNX Software Systems

Printed under license by:

QNX Software Systems Co.175 Terence Matthews CrescentKanata, OntarioK2M 1W8CanadaVoice: +1 613 591-0931Fax: +1 613 591-3579Email: [email protected]: http://www.qnx.com/

1996 2005, QNX Software Systems. All rights reserved.

Third-party copyright notices

All appropriate copyright notices for third-party software are published in this manual in an appendix called Third-Party CopyrightNotices.

Publishing history

December 1996 First edition

July 1997 Second edition

August 1999 Third edition

July 2004 Fourth edition

Electronic edition published 2005

Technical support options

To obtain technical support for any QNX product, visit the Technical Support section in the Services area on our website(www.qnx.com). Youll find a wide range of support options, including our free web-based Developer Support Center.

QNX, Momentics, Neutrino, and Photon microGUI are registered trademarks of QNX Software Systems in certain jurisdictions. All other trademarks and

trade names belong to their respective owners.

Printed in Canada.

Part Number: 002505

Contents

About This Reference liTypographical conventions liii

Note to Windows users liv

What youll find in this guide lv

Whats new in QNX Neutrino 6.3.0 Service Pack 2 lv

New Content lv

Changed Content lvi

Errata lvi

Whats new in QNX Neutrino 6.3.0 Service Pack 1 lvii

New content lvii

Changed content lviii

Errata lix

Whats new in QNX Neutrino 6.3.0 lx

New content lx

Whats new in QNX Neutrino 6.2.1 lxii

New content lxii

Changed content lxii

Errata lxii

Whats new in QNX Neutrino 6.2 lxv

New Content lxv

Deprecated Content lxviii

Errata lxviii

Whats new in the QNX Neutrino 6.1.0 docs lxviii

New content lxviii

Deprecated content lxix

October 6, 2005 Contents iii


Summary of Functions 1Summary of function categories 3

Asynchronous I/O functions 6

Atomic functions 7

Character manipulation functions 8

Conversion functions 9

Directory functions 12

Dispatch interface functions 13

File manipulation functions 17

IPC functions 19

Hardware functions 25

Math functions 27

Memory allocation functions 33

Memory manipulation functions 34

Message-queue functions 36

Multibyte character functions 37

QNX Neutrino-specific IPC functions 37

Operating system I/O functions 40

PC Card functions 44

Platform-specific functions 44

Process environment functions 46

Process manipulation functions 49

Realtime timer functions 58

Resource manager functions 60

Searching and sorting functions 65

Shared memory functions 67

Signal functions 67

Stream I/O functions 69

String manipulation functions 72

System database functions 75

System message log functions 76

TCP/IP functions 77

iv Contents October 6, 2005


Terminal control functions 85

Thread functions 86

Time functions 95

Variable-length argument list functions 98

Wide-character functions 98

Whats in a function description? 102

Synopsis: 102

Arguments: 103

Library: 103

Description: 103

Returns: 103

Errors: 103

See also: 104

Examples: 104

Classification: 104

Function safety: 108

Manifests 111QNX Neutrino Functions and Macros 115abort() 119

abs() 121

accept() 123

access() 126

acos(), acosf() 129

acosh(), acoshf() 131

addrinfo 133

aio cancel() 135

aio error() 137

aio fsync() 139

aio read() 141

aio return() 142

aio suspend() 144

aio write() 146

October 6, 2005 Contents v


alarm() 147

alloca() 150

alphasort() 153

amblksiz 155

argc 157

argv 158

asctime(), asctime r() 159

asin(), asinf() 161

asinh(), asinhf() 163

assert() 165

asyncmsg channel create() 168

asyncmsg channel destroy() 171

asyncmsg connect attach() 173

asyncmsg connect attr() 176

asyncmsg connect detach() 178

asyncmsg connection attr 180

asyncmsg flush() 182

asyncmsg free() 184

asyncmsg get() 186

asyncmsg malloc() 188

asyncmsg put(), asyncmsg putv() 190

atan(), atanf() 193

atan2(), atan2f() 195

atanh(), atanhf() 197

atexit() 199

atof() 202

atoh() 204

atoi() 206

atol(), atoll() 208

atomic add() 210

atomic add value() 212

atomic clr() 214

vi Contents October 6, 2005


atomic clr value() 216

atomic set() 218

atomic set value() 220

atomic sub() 222

atomic sub value() 224

atomic toggle() 226

atomic toggle value() 228

auxv 230

basename() 231

bcmp() 234

bcopy() 236

bind() 238

bindresvport() 241

brk() 243

bsearch() 246

btext 249

btowc() 250

bzero() 252

cabs(), cabsf() 254

cache fini() 256

CACHE FLUSH() 258

cache init() 260

CACHE INVAL() 266

calloc() 269

cbrt(), cbrtf() 271

ceil(), ceilf() 273

cfgetispeed() 275

cfgetospeed() 277

cfgopen() 279

cfmakeraw() 283

cfree() 285

cfsetispeed() 287

October 6, 2005 Contents vii


cfsetospeed() 290

ChannelCreate(), ChannelCreate r() 293

ChannelDestroy(), ChannelDestroy r() 300

chdir() 303

chmod() 306

chown() 310

chroot() 313

chsize() 316

clearenv() 319

clearerr() 322

clock() 324

clock getcpuclockid() 326

clock getres() 328

clock gettime() 330

clock nanosleep() 333

clock settime() 337

ClockAdjust(), ClockAdjust r() 340

ClockCycles() 343

ClockId(), ClockId r() 345

ClockPeriod(), ClockPeriod r() 348

ClockTime(), ClockTime r() 352

close() 355

closedir() 357

closelog() 360

cmdfd() 361

cmdname() 362

confstr() 365

connect() 370

ConnectAttach(), ConnectAttach r() 373

ConnectClientInfo(), ConnectClientInfo r() 378

ConnectDetach(), ConnectDetach r() 382

ConnectFlags(), ConnectFlags r() 384

viii Contents October 6, 2005


ConnectServerInfo(), ConnectServerInfo r() 387

copysign(), copysignf() 390

cos(), cosf() 392

cosh(), coshf() 394

creat(), creat64() 396

crypt() 400

ctermid() 402

ctime(), ctime r() 404

daemon() 407

daylight 409

DebugBreak() 410

DebugKDBreak() 412

DebugKDOutput() 413

delay() 415

devctl() 417

difftime() 427

dircntl() 429

dirname() 432

dispatch block() 435

dispatch context alloc() 439

dispatch context free() 442

dispatch create() 444

dispatch destroy() 448

dispatch handler() 451

dispatch timeout() 455

dispatch unblock() 458

div() 460

dladdr() 462

dlclose() 465

dlerror() 467

dlopen() 469

dlsym() 476

October 6, 2005 Contents ix


dn comp() 479

dn expand() 481

drand48() 483

drem(), dremf() 485

ds clear() 487

ds create() 489

ds deregister() 492

ds flags() 494

ds get() 496

ds register() 498

ds set() 500

dup() 502

dup2() 505

eaccess() 508

edata 511

encrypt() 512

end 514

endgrent() 515

endhostent() 516

ENDIAN BE16() 517

ENDIAN BE32() 519

ENDIAN BE64() 521

ENDIAN LE16() 523

ENDIAN LE32() 525

ENDIAN LE64() 527

ENDIAN RET16() 529

ENDIAN RET32() 531

ENDIAN RET64() 533

ENDIAN SWAP16() 535

ENDIAN SWAP32() 537

ENDIAN SWAP64() 539

endnetent() 541

x Contents October 6, 2005


endprotoent() 542

endpwent() 543

endservent() 544

endspent() 545

endutent() 546

environ 547

eof() 548

erand48() 550

erf(), erff() 552

erfc(), erfcf() 554

err(), errx() 556

errno 559

etext 567

execl() 568

execle() 574

execlp() 581

execlpe() 587

execv() 592

execve() 598

execvp() 604

execvpe() 610

exit() 615

exit() 618

exp(), expf() 621

expm1(), expm1f() 623

C Library F to H 627fabs(), fabsf() 630

fcfgopen() 632

fchmod() 634

fchown() 637

fclose() 640

fcloseall() 642

October 6, 2005 Contents xi


fcntl() 644

fdatasync() 653

fdopen() 655

feof() 658

ferror() 660

fflush() 662

ffs() 664

fgetc() 665

fgetchar() 667

fgetpos() 669

fgets() 671

fgetspent() 674

fgetwc() 677

fgetws() 679

fileno() 682

finite(), finitef() 685

flink() 687

flock() 690

flockfile() 693

floor(), floorf() 695

flushall() 697

fmod(), fmodf() 699

fnmatch() 702

fopen(), fopen64() 706

fork() 711

forkpty() 715

fp exception mask() 717

fp exception value() 720

fp precision() 723

fp rounding() 726

fpathconf() 729

fprintf() 732

xii Contents October 6, 2005


fputc() 734

fputchar() 736

fputs() 738

fputwc() 740

fputws() 742

fread() 744

free() 747

freeaddrinfo() 749

freeifaddrs() 751

freopen(), freopen64() 752

frexp(), frexpf() 756

fscanf() 758

fseek(), fseeko() 760

fsetpos() 763

fstat(), fstat64() 765

fstatvfs(), fstatvfs64() 769

fsync() 773

ftell(), ftello() 775

ftime() 778

ftruncate(), ftruncate64() 781

ftrylockfile() 784

ftw(), ftw64() 786

funlockfile() 789

futime() 791

fwide() 794

fwprintf() 796

fwrite() 798

fwscanf() 801

gai strerror() 803

gamma(), gamma r(), gammaf(), gammaf r() 805

getaddrinfo() 808

getc() 815

October 6, 2005 Contents xiii


getc unlocked() 817

getchar() 819

getchar unlocked() 821

getcwd() 823

getdomainname() 826

getdtablesize() 828

getegid() 830

getenv() 832

geteuid() 834

getgid() 836

getgrent() 838

getgrgid() 841

getgrgid r() 843

getgrnam() 846

getgrnam r() 848

getgrouplist() 851

getgroups() 854

gethostbyaddr() 856

gethostbyaddr r() 859

gethostbyname(), gethostbyname2() 862

gethostbyname r() 865

gethostent() 868

gethostent r() 870

gethostname() 873

getifaddrs() 875

GETIOVBASE() 877

GETIOVLEN() 879

getitimer() 881

getlogin() 883

getlogin r() 885

getnameinfo() 887

getnetbyaddr() 892

xiv Contents October 6, 2005


getnetbyname() 894

getnetent() 896

getopt() 898

getpass() 904

getpeername() 906

getpgid() 908

getpgrp() 910

getpid() 912

getppid() 914

getprio() 916

getprotobyname() 918

getprotobynumber() 920

getprotoent() 922

getpwent() 924

getpwnam() 927

getpwnam r() 929

getpwuid() 932

getpwuid r() 934

getrlimit(), getrlimit64() 937

getrusage() 940

gets() 945

getservbyname() 947

getservbyport() 949

getservent() 951

getsid() 953

getsockname() 955

getsockopt() 957

getspent(), getspent r() 968

getspnam(), getspnam r() 972

getsubopt() 975

gettimeofday() 980

getuid() 982

October 6, 2005 Contents xv


getutent() 984

getutid() 986

getutline() 989

getw() 991

getwc() 993

getwchar() 995

getwd() 997

glob() 999

globfree() 1004

gmtime() 1006

gmtime r() 1008

h errno 1010

hcreate() 1012

hdestroy() 1014

herror() 1015

hostent 1018

hsearch() 1020

hstrerror() 1024

htonl() 1026

htons() 1028

hwi find item() 1030

hwi find tag() 1032

hwi off2tag() 1034

hwi tag2off() 1036

hypot(), hypotf() 1038

C Library I to L 1041ICMP 1044

ICMP6 1046

if freenameindex() 1049

if indextoname() 1051

if nameindex() 1053

if nametoindex() 1055

xvi Contents October 6, 2005


ifaddrs 1057

ilogb(), ilogbf() 1059

in8() 1061

in8s() 1063

in16(), inbe16(), inle16() 1065

in16s() 1067

in32(), inbe32(), inle32() 1069

in32s() 1071

index() 1073

inet addr() 1075

inet aton() 1077

inet lnaof() 1079

inet makeaddr() 1081

inet net ntop() 1083

inet netof() 1086

inet net pton() 1088

inet network() 1090

inet ntoa() 1092

inet ntoa r() 1094

inet ntop() 1096

inet pton() 1099

INET6 1104

inet6 option alloc() 1108

inet6 option append() 1110

inet6 option find() 1112

inet6 option init() 1114

inet6 option next() 1116

inet6 option space() 1118

inet6 rthdr add() 1120

inet6 rthdr getaddr() 1122

inet6 rthdr getflags() 1124

inet6 rthdr init() 1126

October 6, 2005 Contents xvii


inet6 rthdr lasthop() 1128

inet6 rthdr reverse() 1130

inet6 rthdr segments() 1132

inet6 rthdr space() 1134

initgroups() 1136

initstate() 1138

input line() 1141

InterruptAttach(), InterruptAttach r() 1143

InterruptAttachEvent(), InterruptAttachEvent r() 1152

InterruptDetach(), InterruptDetach r() 1158

InterruptDisable() 1161

InterruptEnable() 1163

InterruptHookIdle() 1165

InterruptHookTrace() 1169

InterruptLock() 1171

InterruptMask() 1173

InterruptUnlock() 1176

InterruptUnmask() 1178

InterruptWait(), InterruptWait r() 1180

intr v86() 1183

io connect 1187

io connect ftype reply 1194

io connect link reply 1196

ioctl() 1199

iofdinfo() 1201

iofunc attr init() 1203

iofunc attr lock() 1205

iofunc attr t 1207

iofunc attr trylock() 1213

iofunc attr unlock() 1215

iofunc check access() 1217

iofunc chmod() 1221

xviii Contents October 6, 2005


iofunc chmod default() 1224

iofunc chown() 1226

iofunc chown default() 1229

iofunc client info() 1231

iofunc close dup() 1233

iofunc close dup default() 1236

iofunc close ocb() 1238

iofunc close ocb default() 1240

iofunc devctl() 1242

iofunc devctl default() 1246

iofunc fdinfo() 1248

iofunc fdinfo default() 1251

iofunc func init() 1255

iofunc link() 1258

iofunc lock() 1262

iofunc lock calloc() 1264

iofunc lock default() 1266

iofunc lock free() 1269

iofunc lock ocb default() 1271

iofunc lseek() 1273

iofunc lseek default() 1276

iofunc mknod() 1278

iofunc mmap() 1281

iofunc mmap default() 1285

iofunc notify() 1287

iofunc notify remove() 1294

iofunc notify trigger() 1296

iofunc ocb attach() 1299

iofunc ocb calloc() 1301

iofunc ocb detach() 1304

iofunc ocb free() 1307

iofunc ocb t 1309

October 6, 2005 Contents xix


iofunc open() 1312

iofunc open default() 1317

iofunc openfd() 1319

iofunc openfd default() 1323

iofunc pathconf() 1325

iofunc pathconf default() 1328

iofunc read default() 1330

iofunc read verify() 1332

iofunc readlink() 1336

iofunc rename() 1339

iofunc space verify() 1343

iofunc stat() 1347

iofunc stat default() 1349

iofunc sync() 1352

iofunc sync default() 1354

iofunc sync verify() 1356

iofunc time update() 1359

iofunc unblock() 1361

iofunc unblock default() 1363

iofunc unlink() 1366

iofunc unlock ocb default() 1369

iofunc utime() 1371

iofunc utime default() 1374

iofunc write default() 1377

iofunc write verify() 1379

ionotify() 1383

IP 1389

IPsec 1396

ipsec dump policy() 1404

ipsec get policylen() 1406

ipsec strerror() 1408

ipsec set policy() 1410

xx Contents October 6, 2005


IP6 1415

isalnum() 1425

isalpha() 1427

isascii() 1429

isatty() 1431

iscntrl() 1433

isdigit() 1435

isfdtype() 1437

isgraph() 1439

isinf(), isinff() 1441

islower() 1443

isnan(), isnanf() 1445

isprint() 1447

ispunct() 1449

isspace() 1451

isupper() 1454

iswalnum() 1456

iswalpha() 1458

iswcntrl() 1460

iswctype() 1462

iswdigit() 1464

iswgraph() 1466

iswlower() 1468

iswprint() 1470

iswpunct() 1472

iswspace() 1474

iswupper() 1476

iswxdigit() 1478

isxdigit() 1480

itoa() 1482

j0(), j0f() 1485

j1(), j1f() 1487

October 6, 2005 Contents xxi


jn(), jnf() 1489

jrand48() 1491

kill() 1493

killpg() 1496

labs() 1498

lchown() 1500

lcong48() 1503

ldexp(), ldexpf() 1505

ldiv() 1507

lfind() 1509

lgamma(), lgamma r(), lgammaf(), lgammaf r() 1512

link() 1515

lio listio() 1519

listen() 1524

localeconv() 1526

localtime() 1531

localtime r() 1533

lockf() 1535

log(), logf() 1539

log1p(), log1pf() 1541

log10(), log10f() 1543

logb(), logbf() 1545

login tty() 1548

longjmp() 1550

lrand48() 1553

lsearch() 1555

lseek(), lseek64() 1558

lstat(), lstat64() 1562

ltoa(), lltoa() 1565

ltrunc() 1568

C Library M to O 1573main() 1576

xxii Contents October 6, 2005


mallinfo() 1579

malloc() 1581

mallopt() 1584

max() 1588

mblen() 1590

mbrlen() 1593

mbrtowc() 1595

mbsinit() 1598

mbsrtowcs() 1600

mbstowcs() 1602

mbtowc() 1605

mcheck() 1608

mem offset(), mem offset64() 1610

memalign() 1614

memccpy() 1616

memchr() 1618

memcmp() 1620

memcpy() 1622

memcpyv() 1624

memicmp() 1626

memmove() 1628

memset() 1630

message attach() 1632

message connect() 1639

message detach() 1642

min() 1645

mkdir() 1647

mkfifo() 1650

mknod() 1653

mkstemp() 1657

mktemp() 1659

mktime() 1661

October 6, 2005 Contents xxiii


mlock() 1664

mlockall() 1666

mmap(), mmap64() 1668

mmap device io() 1675

mmap device memory() 1677

modem open() 1681

modem read() 1685

modem script() 1688

modem write() 1696

modf(), modff() 1699

mount() 1701

mount parse generic args() 1704

mprobe() 1707

mprotect() 1710

mq close() 1713

mq getattr() 1715

mq notify() 1718

mq open() 1721

mq receive() 1726

mq send() 1729

mq setattr() 1732

mq timedreceive() 1735

mq timedsend() 1738

mq unlink() 1741

mrand48() 1743

msg info 1745

MsgDeliverEvent(), MsgDeliverEvent r() 1748

MsgError(), MsgError r() 1756

MsgInfo(), MsgInfo r() 1759

MsgKeyData(), MsgKeyData r() 1761

MsgRead(), MsgRead r() 1769

MsgReadv(), MsgReadv r() 1773

xxiv Contents October 6, 2005


MsgReceive(), MsgReceive r() 1776

MsgReceivePulse(), MsgReceivePulse r() 1782

MsgReceivePulsev(), MsgReceivePulsev r() 1785

MsgReceivev(), MsgReceivev r() 1788

MsgReply(), MsgReply r() 1792

MsgReplyv(), MsgReplyv r() 1795

MsgSend(), MsgSend r() 1798

MsgSendnc(), MsgSendnc r() 1802

MsgSendPulse(), MsgSendPulse r() 1806

MsgSendsv(), MsgSendsv r() 1810

MsgSendsvnc(), MsgSendsvnc r() 1814

MsgSendv(), MsgSendv r() 1818

MsgSendvnc(), MsgSendvnc r() 1822

MsgSendvs(), MsgSendvs r() 1826

MsgSendvsnc(), MsgSendvsnc r() 1830

MsgVerifyEvent(), MsgVerifyEvent r() 1834

MsgWrite(), MsgWrite r() 1836

MsgWritev(), MsgWritev r() 1840

msync() 1843

munlock() 1846

munlockall() 1848

munmap() 1850

munmap device io() 1852

munmap device memory() 1854

name attach() 1856

name close() 1863

name detach() 1865

name open() 1867

nanosleep() 1870

nanospin() 1872

nanospin calibrate() 1874

nanospin count() 1877

October 6, 2005 Contents xxv


nanospin ns() 1879

nanospin ns to count() 1881

nap() 1884

napms() 1885

nbaconnect() 1886

nbaconnect result() 1889

ND NODE CMP() 1891

netent 1893

netmgr ndtostr() 1894

netmgr remote nd() 1899

netmgr strtond() 1901

nextafter(), nextafterf() 1903

nftw(), nftw64() 1906

nice() 1910

nrand48() 1912

nsec2timespec() 1914

ntohl() 1916

ntohs() 1918

offsetof() 1920

open(), open64() 1922

opendir() 1930

openfd() 1933

openlog() 1936

openpty() 1939

out8() 1941

out8s() 1943

out16(), outbe16(), outle16() 1945

out16s() 1947

out32(), outbe32(), outle32() 1949

out32s() 1951

C Library P to R 1953pathconf() 1956

xxvi Contents October 6, 2005


pathfind(), pathfind r() 1960

pathmgr symlink() 1964

pathmgr unlink() 1966

pause() 1968

pccard arm() 1970

pccard attach() 1974

pccard detach() 1976

pccard info() 1978

pccard lock() 1981

pccard raw read() 1983

pccard unlock() 1985

pci attach() 1987

pci attach device() 1989

pci detach() 1999

pci detach device() 2001

pci find class() 2003

pci find device() 2005

pci irq routing options() 2007

pci map irq() 2010

pci present() 2012

pci read config() 2015

pci read config8() 2017



pci rescan bus() 2023

pci write config() 2025

pci write config8() 2028



pclose() 2034

perror() 2036

pipe() 2038

October 6, 2005 Contents xxvii


poll() 2040

popen() 2047

posix mem offset(), posix mem offset64() 2051

posix memalign() 2053

pow(), powf() 2055

pread(), pread64() 2057

printf() 2060

procmgr daemon() 2070

procmgr event notify() 2072

procmgr event trigger() 2077

procmgr guardian() 2079

procmgr session() 2082

progname 2085

protoent 2086

pthread abort() 2087

pthread atfork() 2089

pthread attr destroy() 2091

pthread attr getdetachstate() 2093

pthread attr getguardsize() 2095

pthread attr getinheritsched() 2097

pthread attr getschedparam() 2099

pthread attr getschedpolicy() 2101

pthread attr getscope() 2103

pthread attr getstackaddr() 2105

pthread attr getstacklazy() 2107

pthread attr getstacksize() 2109

pthread attr init() 2111

pthread attr setdetachstate() 2114

pthread attr setguardsize() 2116

pthread attr setinheritsched() 2119

pthread attr setschedparam() 2121

pthread attr setschedpolicy() 2123

xxviii Contents October 6, 2005


pthread attr setscope() 2125

pthread attr setstackaddr() 2127

pthread attr setstacklazy() 2129

pthread attr setstacksize() 2131

pthread barrier destroy() 2133

pthread barrier init() 2135

pthread barrier wait() 2137

pthread barrierattr destroy() 2139

pthread barrierattr getpshared() 2141

pthread barrierattr init() 2143

pthread barrierattr setpshared() 2145

pthread cancel() 2147

pthread cleanup pop() 2149

pthread cleanup push() 2151

pthread cond broadcast() 2154

pthread cond destroy() 2156

pthread cond init() 2158

pthread cond signal() 2160

pthread cond timedwait() 2162

pthread cond wait() 2166

pthread condattr destroy() 2169

pthread condattr getclock() 2171

pthread condattr getpshared() 2173

pthread condattr init() 2175

pthread condattr setclock() 2177

pthread condattr setpshared() 2179

pthread create() 2181

pthread detach() 2186

pthread equal() 2188

pthread exit() 2190

pthread getconcurrency() 2192

pthread getcpuclockid() 2194

October 6, 2005 Contents xxix


pthread getschedparam() 2196

pthread getspecific() 2198

pthread join() 2200

pthread key create() 2202

pthread key delete() 2206

pthread kill() 2208

pthread mutex destroy() 2210

pthread mutex getprioceiling() 2212

pthread mutex init() 2214

pthread mutex lock() 2216

pthread mutex setprioceiling() 2220

pthread mutex timedlock() 2222

pthread mutex trylock() 2225

pthread mutex unlock() 2227

pthread mutexattr destroy() 2229

pthread mutexattr getprioceiling() 2231

pthread mutexattr getprotocol() 2233

pthread mutexattr getpshared() 2235

pthread mutexattr getrecursive() 2237

pthread mutexattr gettype() 2239

pthread mutexattr init() 2242

pthread mutexattr setprioceiling() 2244

pthread mutexattr setprotocol() 2246

pthread mutexattr setpshared() 2248

pthread mutexattr setrecursive() 2250

pthread mutexattr settype() 2252

pthread once() 2255

pthread rwlock destroy() 2258

pthread rwlock init() 2260

pthread rwlock rdlock() 2263

pthread rwlock timedrdlock() 2265

pthread rwlock timedwrlock() 2268

xxx Contents October 6, 2005


pthread rwlock tryrdlock() 2271

pthread rwlock trywrlock() 2273

pthread rwlock unlock() 2275

pthread rwlock wrlock() 2277

pthread rwlockattr destroy() 2279

pthread rwlockattr getpshared() 2281

pthread rwlockattr init() 2283

pthread rwlockattr setpshared() 2285

pthread self() 2287

pthread setcancelstate() 2288

pthread setcanceltype() 2290

pthread setconcurrency() 2292

pthread setschedparam() 2294

pthread setspecific() 2296

pthread sigmask() 2298

pthread sleepon broadcast() 2300

pthread sleepon lock() 2302

pthread sleepon signal() 2304

pthread sleepon timedwait() 2306

pthread sleepon unlock() 2310

pthread sleepon wait() 2312

pthread spin destroy() 2316

pthread spin init() 2318

pthread spin lock() 2320

pthread spin trylock() 2322

pthread spin unlock() 2324

pthread testcancel() 2326

pthread timedjoin() 2327

pulse 2330

pulse attach() 2332

pulse detach() 2336

putc() 2339

October 6, 2005 Contents xxxi


putc unlocked() 2341

putchar() 2343

putchar unlocked() 2345

putenv() 2347

puts() 2350

putspent() 2352

pututline() 2355

putw() 2358

putwc() 2360

putwchar() 2362

pwrite(), pwrite64() 2364

qnx crypt() 2367

qsort() 2369

Raccept() 2373

raise() 2375

rand() 2378

rand r() 2380

random() 2382

Rbind() 2385

rcmd() 2387

Rconnect() 2390

rdchk() 2392

re comp() 2394

re exec() 2396

read() 2398

read main config file() 2403

readblock() 2407

readcond() 2410

readdir() 2416

readdir r() 2420

readlink() 2423

readv() 2426

xxxii Contents October 6, 2005


realloc() 2430

realpath() 2433

recv() 2435

recvfrom() 2438

recvmsg() 2442

regcomp() 2446

regerror() 2451

regexec() 2453

regfree() 2456

remainder(), remainderf() 2458

remove() 2460

rename() 2463

res init() 2466

res mkquery() 2469

res query() 2472

res querydomain() 2475

res search() 2478

res send() 2481

resmgr attach() 2484

resmgr block() 2493

resmgr connect funcs t 2496

resmgr context alloc() 2498

resmgr context free() 2501

resmgr context t 2503

resmgr detach() 2505

resmgr devino() 2509

resmgr handle grow() 2512

resmgr handle tune() 2514

resmgr handler() 2517

resmgr io func() 2520

resmgr io funcs t 2522

resmgr iofuncs() 2527

October 6, 2005 Contents xxxiii


resmgr msgread() 2529

resmgr msgreadv() 2531

resmgr msgwrite() 2533

resmgr msgwritev() 2535

RESMGR NPARTS() 2537

resmgr ocb() 2539

resmgr open bind() 2541

resmgr pathname() 2544

RESMGR PTR() 2547

RESMGR STATUS() 2549

resmgr unbind() 2551

rewind() 2553

rewinddir() 2556

Rgetsockname() 2559

rindex() 2561

rint(), rintf() 2563

Rlisten() 2566

rmdir() 2568

ROUTE 2571

Rrcmd() 2578

rresvport() 2580

Rselect() 2582

rsrcdbmgr attach() 2584

rsrcdbmgr create() 2591

rsrcdbmgr destroy() 2595

rsrcdbmgr detach() 2597

rsrcdbmgr devno attach() 2599

rsrcdbmgr devno detach() 2603

rsrcdbmgr query() 2605

ruserok() 2608

C Library S 2611sbrk() 2614

xxxiv Contents October 6, 2005


scalb(), scalbf() 2617

scalbn(), scalbnf() 2620

scalloc() 2623

scandir() 2625

scanf() 2627

sched getparam() 2636

sched get priority adjust() 2639

sched get priority max() 2641

sched get priority min() 2643

sched getscheduler() 2645

sched param 2647

sched rr get interval() 2653

sched setparam() 2655

sched setscheduler() 2658

sched yield() 2661

SchedGet(), SchedGet r() 2664

SchedInfo(), SchedInfo r() 2667

SchedSet(), SchedSet r() 2670

SchedYield(), SchedYield r() 2673

SCTP 2675

sctp bindx() 2677

sctp connectx() 2680

sctp freeladdrs() 2682

sctp freepaddrs() 2683

sctp getladdrs() 2684

sctp getpaddrs() 2686

sctp peeloff() 2688

sctp recvmsg() 2690

sctp sendmsg() 2693

searchenv() 2697

seed48() 2700

seekdir() 2702

October 6, 2005 Contents xxxv


select() 2704

select attach() 2710

select detach() 2714

select query() 2717

sem close() 2720

sem destroy() 2722

sem getvalue() 2724

sem init() 2726

sem open() 2729

sem post() 2734

sem timedwait() 2736

sem trywait() 2739

sem unlink() 2741

sem wait() 2743

send() 2745

sendmsg() 2748

sendto() 2751

servent 2754

setbuf() 2755

setbuffer() 2757

setdomainname() 2759

setegid() 2761

setenv() 2764

seteuid() 2767

setgid() 2770

setgrent() 2773

setgroups() 2775

sethostent() 2777

sethostname() 2779

SETIOV() 2781

setitimer() 2783

setjmp() 2786

xxxvi Contents October 6, 2005


setkey() 2789

setlinebuf() 2791

setlocale() 2793

setlogmask() 2796

setnetent() 2798

setpgid() 2800

setpgrp() 2803

setprio() 2804

setprotoent() 2806

setpwent() 2808

setregid() 2809

setreuid() 2812

setrlimit(), setrlimit64() 2814

setservent() 2821

setsid() 2823

setsockopt() 2825

setspent() 2828

setstate() 2829

settimeofday() 2831

setuid() 2833

setutent() 2836

setvbuf() 2838

sfree() 2841

shm ctl() 2843

shm ctl special() 2852

shm open() 2855

shm unlink() 2862

shutdown() 2864

sigaction() 2866

sigaddset() 2872

sigblock() 2874

sigdelset() 2876

October 6, 2005 Contents xxxvii


sigemptyset() 2878

sigevent 2880

sigfillset() 2885

sigismember() 2887

siglongjmp() 2889

sigmask() 2891

signal() 2893

SignalAction(), SignalAction r() 2897

SignalKill(), SignalKill r() 2905

SignalProcmask(), SignalProcmask r() 2911

SignalSuspend(), SignalSuspend r() 2916

SignalWaitinfo(), SignalWaitinfo r() 2919

significand(), significandf() 2922

sigpause() 2925

sigpending() 2927

sigprocmask() 2929

sigqueue() 2932

sigsetjmp() 2935

sigsetmask() 2937

sigsuspend() 2939

sigtimedwait() 2941

sigunblock() 2944

sigwait() 2946

sigwaitinfo() 2948

sin(), sinf() 2950

sinh(), sinhf() 2952

sleep() 2954

sleepon broadcast() 2956

sleepon destroy() 2958

sleepon init() 2960

sleepon lock() 2962

sleepon signal() 2964

xxxviii Contents October 6, 2005


sleepon unlock() 2966

sleepon wait() 2968

slogb() 2970

slogf() 2972

slogi() 2976

smalloc() 2978

snmp close() 2980

snmp free pdu() 2982

snmp open() 2984

snmp pdu 2986

snmp pdu create() 2990

snmp read() 2992

snmp select info() 2994

snmp send() 2997

snmp session 3000

snmp timeout() 3004

snprintf() 3006

sockatmark() 3009

socket() 3011

socketpair() 3015

SOCKSinit() 3018

sopen() 3020

sopenfd() 3025

spawn() 3028

spawnl() 3038

spawnle() 3043

spawnlp() 3048

spawnlpe() 3052

spawnp() 3057

spawnv() 3064

spawnve() 3069

spawnvp() 3074

October 6, 2005 Contents xxxix


spawnvpe() 3078

sprintf() 3083

sqrt(), sqrtf() 3085

srand() 3087

srand48() 3089

srandom() 3091

srealloc() 3093

sscanf() 3096

stat(), stat64() 3098

statvfs(), statvfs64() 3106

stderr 3110

stdin 3111

stdout 3112

straddstr() 3113

strcasecmp() 3115

strcat() 3118

strchr() 3120

strcmp() 3122

strcmpi() 3124

strcoll() 3126

strcpy() 3128

strcspn() 3130

strdup() 3132

strerror() 3134

strftime() 3136

stricmp() 3142

strlen() 3144

strlwr() 3146

strncasecmp() 3148

strncat() 3151

strncmp() 3153

strncpy() 3155

xl Contents October 6, 2005


strnicmp() 3157

strnset() 3159

strpbrk() 3161

strrchr() 3163

strrev() 3165

strsep() 3167

strset() 3169

strsignal() 3171

strspn() 3173

strstr() 3175

strtod() 3177

strtoimax(), strtoumax() 3180

strtok() 3182

strtok r() 3185

strtol(), strtoll() 3187

strtoul(), strtoull() 3190

strupr() 3193

strxfrm() 3195

swab() 3198

swprintf() 3200

swscanf() 3202

symlink() 3204

sync() 3207

SyncCondvarSignal(), SyncCondvarSignal r() 3209

SyncCondvarWait(), SyncCondvarWait r() 3212

SyncCtl(), SyncCtl r() 3217

SyncDestroy(), SyncDestroy r() 3220

SyncMutexEvent(), SyncMutexEvent r() 3223

SyncMutexLock(), SyncMutexLock r() 3225

SyncMutexRevive(), SyncMutexRevive r() 3228

SyncMutexUnlock(), SyncMutexUnlock r() 3230

SyncSemPost(), SyncSemPost r() 3233

October 6, 2005 Contents xli


SyncSemWait(), SyncSemWait r() 3235

SyncTypeCreate(), SyncTypeCreate r() 3238

sysconf() 3242

sysctl() 3245

syslog() 3253

sysmgr reboot() 3256

SYSPAGE CPU ENTRY() 3258

SYSPAGE ENTRY() 3260

syspage ptr 3263

system() 3264

C Library T to Z 3267tan(), tanf() 3270

tanh(), tanhf() 3272

tcdrain() 3274

tcdropline() 3276

tcflow() 3279

tcflush() 3282

tcgetattr() 3285

tcgetpgrp() 3287

tcgetsid() 3289

tcgetsize() 3291

tcinject() 3293

tcischars() 3296

TCP 3298

tcsendbreak() 3301

tcsetattr() 3303

tcsetpgrp() 3306

tcsetsid() 3309

tcsetsize() 3311

tell(), tell64() 3313

telldir() 3316

tempnam() 3318

xlii Contents October 6, 2005


termios 3320

thread pool control() 3324

thread pool create() 3327

thread pool destroy() 3334

thread pool limits() 3337

thread pool start() 3340

ThreadCancel(), ThreadCancel r() 3343

ThreadCreate(), ThreadCreate r() 3347

ThreadCtl(), ThreadCtl r() 3354

ThreadDestroy(), ThreadDestroy r() 3358

ThreadDetach(), ThreadDetach r() 3361

ThreadJoin(), ThreadJoin r() 3363

time() 3366

timer create() 3368

timer delete() 3372

timer getexpstatus() 3374

timer getoverrun() 3376

timer gettime() 3378

timer settime() 3380

timer timeout(), timer timeout r() 3383

TimerAlarm(), TimerAlarm r() 3390

TimerCreate(), TimerCreate r() 3393

TimerDestroy(), TimerDestroy r() 3397

TimerInfo(), TimerInfo r() 3399

TimerSettime(), TimerSettime r() 3403

TimerTimeout(), TimerTimeout r() 3407

times() 3415

timespec 3418

timespec2nsec() 3419

timezone 3421

tm 3422

tmpfile(), tmpfile64() 3424

October 6, 2005 Contents xliii


tmpnam() 3427

tolower() 3430

toupper() 3432

towctrans() 3434

towlower() 3436

towupper() 3438

TraceEvent() 3440

truncate() 3443

ttyname() 3446

ttyname r() 3448

tzname 3450

tzset() 3451

ualarm() 3454

UDP 3457

ultoa(), ulltoa() 3459

umask() 3462

umount() 3465

UNALIGNED PUT16() 3467



UNALIGNED RET16() 3473



uname() 3479

ungetc() 3482

ungetwc() 3484

UNIX 3486

unlink() 3489

unsetenv() 3492

usleep() 3494

utime() 3496

utimes() 3499

xliv Contents October 6, 2005


utmp 3502

utmpname() 3504

utoa() 3506

va arg() 3509

va copy() 3515

va end() 3517

va start() 3519

valloc() 3521

verr(), verrx() 3523

vfork() 3525

vfprintf() 3527

vfscanf() 3530

vfwprintf() 3533

vfwscanf() 3535

vprintf() 3537

vscanf() 3539

vslogf() 3542

vsnprintf() 3544

vsprintf() 3547

vsscanf() 3550

vswprintf() 3553

vswscanf() 3555

vsyslog() 3557

vwarn(), vwarnx() 3559

vwprintf() 3561

vwscanf() 3563

wait() 3565

wait3() 3568

wait4() 3571

waitid() 3575

waitpid() 3578

warn(), warnx() 3581

October 6, 2005 Contents xlv


wcrtomb() 3583

wcscat() 3585

wcschr() 3587

wcscmp() 3589

wcscoll() 3591

wcscpy() 3593

wcscspn() 3595

wcsftime() 3597

wcslen() 3599

wcsncat() 3601

wcsncmp() 3603

wcsncpy() 3605

wcspbrk() 3607

wcsrchr() 3609

wcsrtombs() 3611

wcsspn() 3613

wcsstr() 3615

wcstod(), wcstof(), wcstold() 3617

wcstoimax(), wcstoumax() 3620

wcstok() 3622

wcstol(), wcstoll() 3624

wcstombs() 3627

wcstoul(), wcstoull() 3630

wcscxfrm() 3633

wctob() 3635

wctomb() 3637

wctrans() 3640

wctype() 3642

wmemchr() 3644

wmemcmp() 3646

wmemcpy() 3648

wmemmove() 3650

xlvi Contents October 6, 2005


wmemset() 3652

wordexp() 3654

wordfree() 3656

wprintf() 3657

write() 3659

writeblock() 3664

writev() 3667

wscanf() 3670

y0(), y0f() 3672

y1(), y1f() 3674

yn(), ynf() 3676

SOCKS A Basic Firewall 3679AAbout SOCKS 3681

How to SOCKSify a client 3681

What SOCKS expects 3682

Third-Party Copyright Notices 3685BBSD stack 3687

BSD stack and various utilities 3688

MINIX operating system 3695

ncurses library 3696

Regular-expression handling 3697

Remote Procedure Call (RPC) 3697

SNMPv2 3698

SOCKS 3699

Summary of Safety Information 3701CCancellation points 3703

Interrupt handlers 3708

Signal handlers 3711

Multithreaded programs 3725

October 6, 2005 Contents xlvii


Glossary 3729

Index 3753

xlviii Contents October 6, 2005

List of Figures

A hierarchy of processes. 1749

A deadlock when sending messages improperly among processes.1750

MsgSendv(), client to process manager. 1762

MsgReplyv(), process manager to client. 1762

MsgSendv(), client to filesystem manager 1763

Components of a fully qualified pathname. 1895

Specifying a guardian for child processes. 2079

Conditions that satisfy an input request. 2411

Most of the spawn*() functions do a lot of work before a messageis sent to procnto. 3030

October 6, 2005 List of Figures xlix

About This Reference

October 6, 2005 About This Reference li

2005, QNX Software Systems Typographical conventions

Typographical conventionsThroughout this manual, we use certain typographical conventions todistinguish technical terms. In general, the conventions we useconform to those found in IEEE POSIX publications. The followingtable summarizes our conventions:

Reference Example

Code examples if( stream == NULL )

Command options -lR

Commands make

Environment variables PATH

File and pathnames /dev/null

Function names exit()

Keyboard chords Ctrl Alt Delete

Keyboard input something you type

Keyboard keys Enter

Program output login:

Programming constants NULL

Programming data types unsigned short

Programming literals 0xFF, "message string"

Variable names stdin

User-interface components Cancel

We format single-step instructions like this:

To reload the current page, press Ctrl R.

We use an arrow () in directions for accessing menu items, like this:

October 6, 2005 About This Reference liii

Typographical conventions 2005, QNX Software Systems

Youll find the Other... menu item underPerspectiveShow View.

We use notes, cautions, and warnings to highlight importantmessages:

Notes point out something important or useful.

CAUTION: Cautions tell you about commands or procedures thatmay have unwanted or undesirable side effects.!

WARNING: Warnings tell you about commands or proceduresthat could be dangerous to your files, your hardware, or evenyourself.

Note to Windows usersIn our documentation, we use a forward slash (/) as a delimiter in allpathnames, including those pointing to Windows files.

We also generally follow POSIX/UNIX filesystem conventions.

liv About This Reference October 6, 2005

2005, QNX Software Systems What youll find in this guide

What youll find in this guideThe Library Reference describes the C functions, data types, andprotocols that are included as part of the QNX Neutrino RTOS.

The Library Reference also contains:

Summary listings of the library, including a description of whatyoull find in a function description

Summary of safety information:

- functions that are cancellation points

- functions that you can safely call from an interrupt handler

- functions that you can safely call from a signal handler

- functions that you cant safely call from a multithreadedprogram.

descriptions of manifests

SOCKS A Basic Firewall

Third-Party Copyright Notices

Glossary

Whats new in QNX Neutrino 6.3.0 ServicePack 2

New Contentcache fini() Free resource when the driver is unloaded.

CACHE FLUSH()

Flush cache line associated to a data buffer.

cache init() Register with the cache coherency library.

CACHE INVAL()

Invalidate cache line associated to a data buffer.

October 6, 2005 About This Reference lv

Whats new in QNX Neutrino 6.3.0 Service Pack 2 2005, QNX Software Systems

Changed Contentmq close(), mq getattr(), mq notify(), mq open(), mq receive(),mq send(), mq setattr(), mq timedreceive(), mq timedsend(),mq unlink()

Added information about the traditional (mqueue) and alternate(mq) implementations of message queues.

nanospin(), nanospin calibrate(), nanospin count(), nanospin ns(),nanospin ns to count()

The nanospin*() functions are designed for use with hardwarethat requires short time delays between accesses. You shoulduse them to delay only for times less than a few milliseconds.For longer delays, use the POSIX timer *() functions.

pci attach device(), pci find class(), pci find device()

For a list of supported device and vendor IDs, see; for a list of class and subclass codes,see .

Erratacmdname() Corrected the information about what this function

returns.

openlog() Corrected the name of the LOG FTP facility.

pci attach device()

The BusNumber and DevFunc members of thepci dev info structure are input/output.

pci irq routing options()

This function is for x86 only.

sem close(), sem open(), sem unlink()

Named semaphores are now managed by procnto,not mqueue.

lvi About This Reference October 6, 2005

2005, QNX Software Systems Whats new in QNX Neutrino 6.3.0 Service Pack 1

thread pool create()

The description of the block func member of thethread pool attr t structure has beencorrected.

vfprintf(), vprintf()

The code samples now compile without warnings.

Whats new in QNX Neutrino 6.3.0 ServicePack 1

New contentasyncmsg channel create()

Create an asynchronous message channel.

asyncmsg channel destroy()

Destroy an asynchronous message channel.

asyncmsg connect attach()

Establish a connection between a process and a channel.

asyncmsg connect attr()

Return the original connection attributes.

asyncmsg connect detach()

Break a connection between a process and a channel.

asyncmsg flush()

Flush the messages sent through the connection.

asyncmsg free()

Free a message buffer.

asyncmsg get()

Receive an asynchronous message.

October 6, 2005 About This Reference lvii

Whats new in QNX Neutrino 6.3.0 Service Pack 1 2005, QNX Software Systems

asyncmsg malloc()

Allocate a message buffer for sending.

asyncmsg put(), asyncmsg putv()

Send asynchronous messages to a connection.

shm ctl special()

Give special attributes to a shared memory object

Changed contentgetdomainname()

If the buffer isnt large enough, getdomainname()truncates the domain name.

getgrouplist() The Neutrino implementation of this functionignores the basegid argument.

mallopt() The MALLOC CKACCESS, MALLOC FILLAREA,and MALLOC CKCHAIN options were added tothis call.

MsgReply(), MsgReply r(), MsgReplyv(), MsgReplyv r()The MsgSend* r() functions use negative errnovalues to indicate failure, so you shouldnt pass anegative value for the status to MsgReply*(),because the MsgSend* r() functions could interpretit as an error code.

name attach() The example now handles an IO CONNECTmessage.

nanospin(), nanospin ns(), and nanospin ns to count()The first time that you call these functions, the Clibrary invokes nanospin calibrate() with anargument of 0 (interrupts enabled), unless you callit directly first.

pci attach device()

Added PCI MASTER ENABLE to the flags.

lviii About This Reference October 6, 2005

2005, QNX Software Systems Whats new in QNX Neutrino 6.3.0 Service Pack 1

procmgr daemon()

The data in the siginfo t structure for theSIGCHLD signal that the parent receives isntuseful in this case.

rsrcdbmgr create()

Added RSRCDBMGR FLAG NOREMOVE to theflags.

setenv() This function doesnt free any memory. If youwant to change the value of an existingenvironment variable, you should use putenv()instead.

sigevent If you dont want to modify the priority of thethread that receives the pulse, specifySIGEV PULSE PRIO INHERIT for the prioritywhen you call SIGEV PULSE INIT().

spawn(), spawnp()

Added descriptions of the rest of the flags forthe inheritance structure.

If you set SPAWN EXEC in the flags member ofthe inheritence structure, these functionsdont return, unless an error occurred.

Erratagetsubopt() Corrected the example.

mq notify() Dont use SIGEV INTR as an event type.

pause() This function suspends the calling thread, not theprocess, until delivery of a signal.

pthread setschedparam()

The timeslice for round-robin scheduling(SCHED RR) is 4 the clock period.

October 6, 2005 About This Reference lix

Whats new in QNX Neutrino 6.3.0 2005, QNX Software Systems

You can specify sporadic scheduling at any time,not just when you create a thread.

regexec() Corrected the description of the regmatch tstructure.

sched get priority max(), sched get priority min(),sched setscheduler(), SchedInfo(), SchedSet()

The timeslice for round-robin scheduling(SCHED RR) is 4 the clock period.

sched setscheduler(), SchedSet()

You can specify sporadic scheduling at any time, notjust when you create a thread.

spawn(), spawnl(), spawnle(), spawnlp(), spawnlpe(), spawnp(),spawnv(), spawnve(), spawnvp(), spawnvpe()

The child process cant access the parent processsenvironment, only its own.

Whats new in QNX Neutrino 6.3.0New content

fopen64() Large-file support for fopen().

freopen64() Large-file support for freopen().

ftw64() Large-file support for ftw().

getnameinfo() Perform address-to-nodename translation.

inet6 option *() Manipulate IPv6 hop-by-hop and destinationoptions.

inet6 rthdr *() manipulate IPv6 Router header options.

ipsec dump policy()

Generate a readable string from an IPsec policyspecification.

lx About This Reference October 6, 2005

2005, QNX Software Systems Whats new in QNX Neutrino 6.3.0

ipsec get policylen()

Get the length of the IPsec policy.

ipsec set policy()

Generate an IPsec policy specification structurefrom a readable string.

nftw(), nftw64() Walk a file tree and its large-file support.

poll() Input/output multiplexing.

resmgr handle tune()

Tune aspects of client fd-to-OCB mapping

sctp bindx() Add or remove one or more addresses from a givenassociation.

sctp connectx() Help associate an endpoint that is multi-homed.

sctp freeladdrs()

Free all resources allocated by sctp getladdrs().

sctp freepaddrs()

Free all resources allocated by sctp getpaddrs().

sctp getladdrs() Return all locally bound addresses on a socket.

sctp getpaddrs() Return all peer addresses in an association.

sctp peeloff() Branch off an association into a seperate socket.

SCTP Stream Control Transmission Protocol.

sctp recvmsg() Receive message using advanced SCTP features.

sctp sendmag() Send message using advanced SCTP features.

tmpfile64() Large-file support for tmpfile().

October 6, 2005 About This Reference lxi


Whats new in QNX Neutrino 6.2.1New content

dispatch unblock()

Unblock all of the threads that are blocked on adispatch handle

errno Each thread in a multi-threaded program has its ownerror value in its thread local storage. No matter whichthread youre in, you can simply refer to errno itsdefined in such a way that it refers to the correctvariable for the thread. For more information, seeLocal storage for private data in the documentationfor ThreadCreate().

pthread attr setschedpolicy().

Sporadic scheduling (SCHED SPORADIC) is a newfeature of QNX Neutrino 6.2.0.

sched param

Structure of scheduling parameters

va copy() Make a copy of a variable argument list

Changed contentbind(), bindresvport()

These functions arent cancellation points any more, becausethis conflicted with POSIX.

htonl(), htons(), inet ntop(), inet pton(), isfdtype(), ntohl(), ntohs()These functions have been moved from libsocket to libc.

Errataalphasort() This function compares two directory entries; it

doesnt sort an array of entries.

lxii About This Reference October 6, 2005

2005, QNX Software Systems Whats new in QNX Neutrino 6.2.1

execlpe(), execvpe()

You can now execute a shell script.

fgetc(), fgetchar(), fgets(), fgetwc(), fgetws(), getc(), getc unlocked(),getchar(), getchar unlocked(), gets(), getw(), getwc(), getwchar()

Use feof() or ferror() to distinguish an end-of-filecondition from an error.

fstat(), fstat64() These functions return -1 if an error occurs.

iofunc mmap(), iofunc mmap default()

These functions return a nonpositive value onsuccess.

InterruptAttach(), InterruptAttachEvent()

You should always setNTO INTR FLAGS TRK MSK.

mq getattr(), mq setattr()

The mq flags member of the mq attr structureapplies to the message-queue description (i.e.locally), not to the queue as a whole.

mq open() Corrected the interpretation of the name argument.

MsgError(), MsgError r()

If the error argument is EOK, the MsgSend*() callreturns EOK; if error is any other value, theMsgSend*() call returns -1.

MsgSendPulse(), MsgSendPulse r()

You can now send pulses across the network.

You can send a pulse to any process not just to aprocess in the same process group if yourprocess has the appropriate permission.

name open() This function returns a nonnegative integerrepresenting a side-channel connection ID, or -1 ifan error occurred.

October 6, 2005 About This Reference lxiii


printf() The exponent produced for the e and E formats isat least two digits long.

Clarified what happens if the format string includesinvalid multibyte characters.

pthread mutex timedlock(), pthread rwlock timedrdlock(),pthread rwlock timedwrlock()

The timeout is based on the CLOCK REALTIMEclock.

resmgr ocb() Corrected the name.

select() This function and the associated macros are nowdefined in , instead of (which includes).

sem open() Corrected the interpretation of the sem nameargument.

sem timedwait() The timeout is based on the CLOCK REALTIMEclock.

send() The list of errors now includes EPIPE.

shm open() Corrected the interpretation of the name argument.

sigaction() Corrected the example (it isnt safe to call printf()in a signal handler).

spawn(), spawnl(), spawnle(), spawnlp(), spawnlpe(), spawnp(),spawnv(), spawnve(), spawnvp(), spawnvpe()

You can now execute a shell script.

The child processs tms utime, tms stime,tms cutime, and tms cstime are now calculated.

timer create() Dont use SIGEV INTR or SIGEV UNBLOCK forthe event type.

vsnprintf() Corrected the returned values.

lxiv About This Reference October 6, 2005

2005, QNX Software Systems Whats new in QNX Neutrino 6.2

Whats new in QNX Neutrino 6.2Significant changes:

New content

Deprecated content

Errata

New Contentaddrinfo TCP/IP address information

dircntl() Control an open directory

freeaddrinfo() Free an address information structure

freeifaddrs() Free an address information structure

gai strerror() Return the getaddrinfo() error code

getaddrinfo() Get address information

getdomainname()

Get the domain name of the current host

gethostbyname2()

Get a network host entry, given a name

getifaddrs() Get a network interface address

hwi find item() Find an item in the hwi item structure

hwi find tag() Find a tag in the hwi item structure

hwi off2tag() Return a pointer to the start of a tag in the hwinfoarea of the system page

hwi tag2off() Return the offset from the start of the hwinfo areaof the system page

ICMP6 Internet Control Message Protocol for IPv6

October 6, 2005 About This Reference lxv

Whats new in QNX Neutrino 6.2 2005, QNX Software Systems

if freenameindex()

Free dynamic memory allocated by if nameindex()

if indextoname() Map an interface index to its name

if nameindex() Return a list of interfaces

if nametoindex() Map an interface name to its index

ifaddrs() Structure that describes an Internet host

INET6 Internet Protocol version 6 family

inet net ntop() Convert an Internet network number to CIDRformat

inet net pton() Convert an Internet network number from CIDRformat to network format

IPv6 Internet Protocol version 6

IPsec Internet security protocol

mallinfo() Get memory allocation information

mallopt() Control the memory allocation

mcheck() Enable memory allocation routine consistencychecks

memalign() Allocate aligned memory

mprobe() Perform consistency check on memory

posix memalign()

Allocate aligned memory

procmgr session()

Provide process manager session support

resmgr handle grow()

Expand the capacity of the device managerdatabase

lxvi About This Reference October 6, 2005

2005, QNX Software Systems Whats new in QNX Neutrino 6.2

resmgr io func()

Retrieve an I/O function from an I/O function table

resmgr iofuncs() Extract the I/O function pointers associated with cconnection

resmgr ocb() Retrieve an Open Control Block

sched get priority adjust()

Calculate the allowable priority for the schedulingpolicy

seekdir() Set the position for the next read of the directorystream

sleepon broadcast()

Wake up multiple threads

sleepon destroy()

Destroy a sleepon

sleepon init() Initialize a sleepon

sleepon lock() Lock a sleepon

sleepon signal()

Wake up a single thread

sleepon unlock()

Unlock a sleepon

sleepon wait() Wait on a sleepon

tcsetsid() Make a terminal device a controlling device

strtoimax(), strtoumax()

Convert a string to an integer type

telldir() Get the location associated with the directorystream

October 6, 2005 About This Reference lxvii

Whats new in the QNX Neutrino 6.1.0 docs 2005, QNX Software Systems

valloc() Allocate a heap block aligned on a page boundary

wcstoimax(), wcstoumax()

Convert a wide-character string to an integer type

Deprecated Content getpriority() use getprio() or SchedGet() instead.

setpriority() use setprio() or SchedSet() instead.

Erratasnprintf() Corrected the Returns section and Classifications

Whats new in the QNX Neutrino 6.1.0 docsSignificant changes:

New content

Deprecated content

New contentThe following functions have been added:

Wide-character functions

Wide-character versions of many functions

InterruptHookTrace()

Attach the pseudo interrupt handler thats used bythe instrumented module

iofdinfo() Retrieve server attributes

iofunc fdinfo() Handle an IO FDINFO message

iofunc fdinfo default()

Default handler for IO FDINFO messages

lxviii About This Reference October 6, 2005

2005, QNX Software Systems Whats new in the QNX Neutrino 6.1.0 docs

MsgVerifyEvent(), MsgVerifyEvent r()

Check the validity of a receive ID and an eventconfiguration

resmgr unbind()

Remove an OCB

straddstr() Concatenate one string on to the end of another

SyncCtl(), SyncCtl r()

Perform an operation on a synchronization object

SyncMutexEvent(), SyncMutexEvent r()

Attach an event to a mutex

SyncMutexRevive(), SyncMutexRevive r()

Revive a mutex

thread pool control()

Control the thread pool behavior

thread pool limits()

Wrapper function for thread pool control()

TraceEvent() Trace kernel events

Deprecated contentmatherr() Handle errors in math library functions

October 6, 2005 About This Reference lxix

Summary of Functions

October 6, 2005 Summary of Functions 1

2005, QNX Software Systems Summary of function categories

Summary of function categoriesWeve organized the functions in the C library into the followingcategories:

Asynchronous I/O functions

Asynchronous read, write, and other I/Ooperations.

Atomic functions

Thread-safe integer manipulation functions.

Character manipulation functions

Single-character functions for upper/lowercaseconversions.

Conversion functions

Convert values from one representation to another(e.g. numeric values to strings).

Directory functions

Directory services (change, open, close, etc.).

Dispatch interface functions

Handle different event types, including messages,pulse codes, and signals.

File manipulation functions

File operations (change permissions, delete,rename, etc.)

IPC functions Traditional InterProcess Communicationfunctions.

Hardware functions

These functions work with PCI and other devices.

Math functions Perform computations such as the commontrigonometric calculations. These functionsoperate with floating-point values.


Summary of function categories 2005, QNX Software Systems

Memory allocation functions

Allocate and deallocate memory.

Memory manipulation functions

Manipulate blocks of memory.

Message-queue functions

Nonblocking message-passing facilities.

Multibyte character functions

ANSI C functions for processing multibyte andwide characters.

QNX Neutrino-specific IPC functions

Native message-passing and related functions.

Operating system I/O functions

POSIX functions for performing I/O at a lowerlevel than the C Language stream I/O functions(e.g. fopen(), fread(), fwrite(), and fclose() ).

PC Card functions

Native PC Card functions.

Platform-specific functions

Invoke Intel 80x86 and other processor-relatedfunctions directly from a program.

Process environment functions

For process identification, user identification,process groups, system identification, system timeand process time, environment variables, terminalidentification, and configurable system variables.

Process manipulation functions

For process creation, execution, and termination;signal handling; and timer operations.

4 Summary of Functions October 6, 2005


Realtime timer functions

Rich set of inexpensive timer functions that arequick to create and manipulate.

Resource manager functions

These functions help you create resourcemanagers.

Searching and sorting functions

Perform various search and sort operations (do abinary search on a sorted array, find one stringinside another, etc.).

Shared-memory functions

Create and manipulate shared-memory regions.

Signal functions Rich set of functions for handling and sendingsignals.

Stream I/O functions

The standard functions to read and write files.Data can be transmitted under format control or ascharacters, strings, or blocks of memory.

String manipulation functions

Manipulate a character string, i.e. an array of zeroor more adjacent characters followed by a NULcharacter (0) that marks the end of the string.

System database functions

Allow an application to access group and userdatabase information.

System message log functions

This set of functions controls the system log.

TCP/IP functions

Handle TCP/IP network communications and theTCP/IP database files.



Terminal control functions

Set and control terminal attributes (baud rate, flowcontrol, etc.).

Thread functions

Operate on threads and the objects used tosynchronize threads.

Time functions Obtain and manipulate times and dates.

Variable-length argument list functions

Process a variable number of arguments to afunction.

Wide-character functions

Wide-character versions of functions from otherfunction summary categories.

The following subsections describe these function categories in moredetail. Each function is noted with a brief description of its purpose.

Asynchronous I/O functionsThese functions perform asynchronous read, write, and other I/Ooperations.

Asynchronous I/O operations arent currently supported.

The following functions are defined:

aio cancel() Cancel an asynchronous I/O operation

aio error() Get the error status for an asynchronous I/Ooperation

aio fsync() Asynchronously synchronize a file

aio read() Asynchronously read from a file



aio return() Get the return status for an asynchronous I/Ooperation

aio suspend() Wait for asynchronous I/O operations to complete

aio write() Asynchronously write to a file

Atomic functionsThese functions manipulate an integer in a thread-safe way. On amultiprocessor system, even a simple:

/*Assuming x is an unsigned variable shared between twoor more threads or a thread and an interrupt handler.

*/

x = 0xdeadbeef;

may cause x to be in an undefined state if multiple threads runningsimultaneously on multiple processors execute this code at the sametime.

Use the atomic*() functions to ensure that your integer operations arecarried out properly:

atomic toggle( &x, 0xdeadbeef );

atomic add() Safely add to a variable

atomic add value()

Safely add to a variable, returning the previousvalue

atomic clr() Safely clear a variable

atomic clr value()

Safely clear a variable, returning the previous value

atomic set() Safely set bits in a variable



atomic set value()

Safely set bits in a variable, returning the previousvalue

atomic sub() Safely subtract from a variable

atomic sub value()

Safely subtract from a variable, returning theprevious value

atomic toggle() Safely toggle a variable

atomic toggle value()

Safely toggle a variable, returning the previousvalue

Character manipulation functionsThese functions operate on single characters of type char. Thefunctions test characters in various ways and convert them betweenupper and lowercase. (Some of these functions have wide-characterversions in the Wide-character functions section of the functionsummary.)

isalnum() Test a character to see if its alphanumeric

isalpha() Test to see if a character is a letter

isascii() Test for a character in the range 0 to 127

iscntrl() Test a character to see if its a control character

isdigit() Test for any decimal digit

isgraph() Test for any printable character except space

islower() Test for any lowercase letter

isprint() Test for any printable character, including space



ispunct() Test for any punctuation character

isspace() Test for a whitespace character

isupper() Test for any uppercase letter

isxdigit() Test for any hexadecimal digit

tolower() Convert a character to lowercase

toupper() Convert a character to uppercase

Conversion functionsThese functions perform conversions between objects of various typesand strings:

atof() Convert a string into a double

atoh() Convert a string containing a hexadecimal numberinto an unsigned number

atoi() Convert a string into an integer

atol(), atoll() Convert a string into a long integer

ENDIAN BE16()

Return a big-endian 16-bit value in native format

ENDIAN BE32()


ENDIAN BE64()


ENDIAN LE16()

Return a little-endian 16-bit value in native format

ENDIAN LE32()




ENDIAN LE64()


ENDIAN RET16()

Return an endian-swapped 16-bit value

ENDIAN RET32()


ENDIAN RET64()


ENDIAN SWAP16()

Endian-swap a 16-bit value in place

ENDIAN SWAP32()


ENDIAN SWAP64()


htonl() Convert a 32-bit value from host-byte order tonetwork-byte order

htons() Convert a 16-bit value from host-byte order tonetwork-byte order

itoa() Convert an integer into a string, using a given base

ltoa(), lltoa() Convert a long integer value into a string, using agiven base

nsec2timespec()

Convert nanoseconds to a timespec structure

ntohl() Convert network-byte order value

ntohs() Convert network-byte order value

strtod() Convert a string into a double



strtoimax(), strtoumax()

Convert a string into an integer

strtol(), strtoll()

Convert a string into a long integer

strtoul(), strtoull()

Convert a string into an unsigned long integer

timespec Time-specification structure

timespec2nsec()

Convert a timespec structure to nanoseconds

ultoa(), ulltoa() Convert an unsigned long integer into a string,using a given base

UNALIGNED PUT16()

Write a misaligned 16-bit value safely

UNALIGNED PUT32()


UNALIGNED PUT64()


UNALIGNED RET16()

Access a misaligned 16-bit value safely

UNALIGNED RET32()


UNALIGNED RET64()


utoa() Convert an unsigned integer into a string, using agiven base

wordexp() Perform word expansions



wordfree() Free a word expansion buffer

See also the following functions, which convert the cases ofcharacters and strings:

strlwr()

strupr()

tolower()

toupper()

Directory functionsThese functions pertain to directory manipulation:

alphasort() Compare two directory entries

chdir() Change the current working directory

chroot() Change the root directory

closedir() Close a directory

dircntl() Control an open directory

dirname() Report the parent directory name of a file pathname

getcwd() Get the name of the current working directory

getwd() Get current working directory pathname

glob() Find paths matching a pattern

globfree() Free storage allocated by a call to glob()

mkdir() Create a subdirectory

mount() Mount a filesystem

mount parse generic args()

Strip off common mount arguments



opendir() Open a directory file

pathfind(), pathfind r()

Search for a file in a list of directories

readdir() Get information about the next matching filename

readdir r() Get information about the next matching filename

realpath() Resolve a pathname

rewinddir() Reset the position of a directory stream to the start ofthe directory

rmdir() Delete an empty directory

scandir() Scan a directory

seekdir() Set the position for the next read of the directorystream

telldir() Get the location associated with the directory stream

umount() Unmount a filesystem

Dispatch interface functionsThese functions make up the dispatch interface where you can handledifferent event types including messages, pulse codes, and signals.The functions cover dispatch contexts, attaching events, attachingpathnames and file descriptors to dispatch contexts, thread pools, etc.For an overview of these functions, see Components of a resourcemanager in the Writing a Resource Manager chapter of the QNXNeutrino Programmers Guide.

dispatch block() Block while waiting for an event

dispatch context alloc()

Return a dispatch context



dispatch context free()

Free a dispatch context

dispatch create()

Allocate a dispatch handle

dispatch destroy()

Destroy a dispatch handle

dispatch handler()

Handle events received by dispatch block()

dispatch timeout()

Set a timeout

dispatch unblock()

Unblock all of the threads that are blocked on adispatch handle

message attach()

Attach a message range

message connect()

Create a connection to a channel

message detach()

Detach a message range

name attach() Register a name in the namespace and create achannel

name detach() Remove a name from the namespace and destroythe channel

pulse Structure that describes a pulse

pulse attach() Attach a handler function to a pulse code

pulse detach() Detach a handler function from a pulse code



resmgr attach() Attach a path to a pathname space

resmgr block() Block while waiting for a message

resmgr connect funcs t

Table of POSIX-level connect functions

resmgr context alloc()

Allocate a resource-manager context

resmgr context free()

Free a resource-manager context

resmgr context t

Context information thats passed betweenresource-manager functions

resmgr detach() Remove a pathname from the pathname space

resmgr devino() Get the device and inode number

resmgr handle grow()

Expand the capacity of the device managerdatabase

resmgr handle tune()

Tune aspects of client fd-to-OCB mapping

resmgr handler()

Handle resource manager messages

resmgr io func()

Retrieve an I/O function from an I/O function table

resmgr io funcs t

Table of POSIX-level I/O functions

resmgr iofuncs() Extract the I/O function pointers associated withclient connections



resmgr msgread()

Read a message from a client

resmgr msgreadv()

Read a message from a client

resmgr msgwrite()

Write a message to a client

resmgr msgwritev()

Write a message to a client

RESMGR NPARTS()

Get a given number of parts from the ctp->iovstructure

resmgr ocb() Retrieve an Open Control Block

resmgr open bind()

Associate an OCB with an open request

resmgr pathname()

Return the pathname associated with an ID

RESMGR PTR()

Get one part from the ctp->iov structure and fill inits fields

RESMGR STATUS()

Set the status member of a resource-managercontext

resmgr unbind() Remove an OCB

select attach() Attach a file descriptor to a dispatch handle

select detach() Detach a file descriptor from a dispatch handle

select query() Decode the last select event



thread pool create()

Create a thread pool handle

thread pool control()

Control the thread pool behavior

thread pool destroy()

Free the memory allocated to a thread pool

thread pool limits()

Wrapper function for thread pool control()

thread pool start()

Start a thread pool

File manipulation functionsThese functions operate directly with files. The following functionsare defined:

access() Check to see if a file or directory can be accessed

chmod() Change the permissions for a file

chown() Change the user ID and group ID of a file

eaccess() Check to see if a file or directory can be accessed(extended version)

glob() Find paths matching a pattern

globfree() Free storage allocated by a call to glob()

fchmod() Change the permissions for a file

fchown() Change the user ID and group ID of a file

fpathconf() Return the value of a configurable limit associatedwith a file or directory



ftruncate(), ftruncate64()

Truncate a file

futime() Record the modification time for a file

lchown() Change the user ID and group ID of a file orsymbolic link

lstat(), lstat64()

Get information about a file or directory

ltrunc() Truncate a file at a given position

mkfifo() Create a FIFO special file

mkstemp() Make a unique temporary filename, and open the file

mktemp() Make a unique temporary filename

nftw(), nftw64()

Walk a file tree

pathconf() Return the value of a configurable limit

pclose() Close a pipe

pwrite(), pwrite64()

Write into a file without changing the file pointer

remove() Remove a link to a file

rename() Rename a file

stat(), stat64()

Get information about a file or directory, given a path

statvfs(), statvfs64()

Get filesystem information, given a path

sync() Synchronize filesystem updates



tempnam() Create a name for a temporary file

truncate() Truncate a file to a specified length

tmpnam() Generate a unique string for use as a filename

unlink() Remove a link to a file

utime() Record the modification time for a file or directory

utimes() Set a files access and modification times

IPC functionsThese functions deal with InterProcess Communications.

flock() Apply or remove an advisory lock on an open file

lockf() Record locking on files

mlock() Lock a buffer in physical memory

mlockall() Lock a processs address space

mmap(), mmap64()

Map a memory region into a process address space

mprotect() Change memory protection

msync() Synchronize memory with physical storage

munlock() Unlock a buffer

munlockall() Unlock a processs address space

munmap() Unmap previously mapped addresses

pthread barrier destroy()

Destroy a barrier object

pthread barrier init()

Initialize a barrier object



pthread barrier wait()

Synchronize at a barrier

pthread barrierattr destroy()

Destroy a barrier attributes object

pthread barrierattr getpshared()

Get the process-shared attribute of a barrierattributes object

pthread barrierattr init()

Initialize a barrier attributes object

pthread barrierattr setpshared()

Set the process-shared attribute of a barrierattributes object

pthread cond broadcast()

Unblock threads waiting on a condition

pthread cond destroy()

Destroy a condition variable

pthread cond init()

Initialize a condition variable

pthread cond signal()

Unblock the thread waiting on a condition variable

pthread cond timedwait()

Wait on a condition variable, with a time limit

pthread cond wait()

Wait on a condition variable

pthread condattr destroy()

Destroy a condition variable attribute object



pthread condattr getclock()

Get the clock attribute from a condition-variableattribute object

pthread condattr getpshared()

Get the process-shared attribute from a conditionvariable attribute object

pthread condattr init()

Initialize a condition variable attribute object

pthread condattr setclock()

Set the clock attribute in a condition-variableattribute object

pthread condattr setpshared()

Set the process-shared attribute in acondition-variable attribute object

pthread mutex destroy()

Destroy a mutex

pthread mutex getprioceiling()

Get a mutexs priority ceiling

pthread mutex init()

Initialize a mutex

pthread mutex lock()

Lock a mutex

pthread mutex setprioceiling()

Set a mutexs priority ceiling

pthread mutex timedlock()

Lock a mutex

pthread mutex trylock()

Attempt to lock a mutex



pthread mutex unlock()

Unlock a mutex

pthread mutexattr destroy()

Destroy a mutex attribute object

pthread mutexattr getprioceiling()

Get the priority ceiling of a mutex attribute object

pthread mutexattr getprotocol()

Get a mutexs scheduling protocol

pthread mutexattr getpshared()

Get the process-shared attribute from a mutexattribute object

pthread mutexattr getrecursive()

Get the recursive attribute from a mutex attributeobject

pthread mutexattr gettype()

Get a mutex type

pthread mutexattr init()

Initialize the mutex attribute object

pthread mutexattr setprioceiling()

Set the priority ceiling of a mutex attribute object

pthread mutexattr setprotocol()

Set a mutexs scheduling protocol

pthread mutexattr setpshared()

Set the process-shared attribute in mutex attributeobject

pthread mutexattr setrecursive()

Set the recursive attribute in mutex attribute object



pthread mutexattr settype()

Set a mutex type

pthread once() Dynamic package initialization

pthread rwlock destroy()

Destroy a read/write lock

pthread rwlock init()

Initialize a read/write lock

pthread rwlock rdlock()

Acquire a shared read lock on a read/write lock

pthread rwlock timedrdlock()

Lock a read-write lock for writing

pthread rwlock timedwrlock()

Attempt to acquire an exclusive write lock on aread/write lock

pthread rwlock tryrdlock()

Attempt to acquire a shared read lock on aread/write lock

pthread rwlock trywrlock()

Attempt to acquire an exclusive write lock on aread/write lock

pthread rwlock unlock()

Unlock a read/write lock

pthread rwlock wrlock()

Acquire an exclusive write lock on a read/writelock

pthread rwlockattr destroy()

Destroy a read-write lock attribute object



pthread rwlockattr getpshared()

Get the process-shared attribute of a read-writelock attribute object

pthread rwlockattr init()

Create a read-write lock attribute object

pthread rwlockattr setpshared()

Set the process-shared attribute of a read-writelock attribute object

pthread spin destroy()

Destroy a thread spinlock

pthread spin init()

Initialize a thread spinlock

pthread spin lock()

Lock a thread spinlock

pthread spin trylock()

Try locking a thread spinlock

pthread spin unlock()

Unlock a thread spinlock

readcond() Read data from a terminal device

sem close() Close a named semaphore

sem destroy() Destroy a semaphore

sem getvalue() Get the value of a semaphore (named or unnamed)

sem init() Initialize a semaphore

sem open() Create or access a named semaphore

sem post() Increment a semaphore

sem timedwait() Wait on a semaphore, with a timeout



sem trywait() Wait on a semaphore, but dont block

sem unlink() Destroy a named semaphore

sem wait() Wait on a semaphore

sync() Synchronize filesystem updates

Hardware functionsThese functions work with PCI and other devices for operations suchas determining whether or not a PCI BIOS is present, attaching adriver to a PCI device, and so on.

The following functions are defined:

pci attach() Connect to the PCI server

pci attach device()

Attach a driver to a PCI device

pci detach() Disconnect from the PCI server

pci detach device()

Detach a driver from a PCI device

pci find class() Find devices that have a specific Class Code

pci find device() Find the PCI device with a given device ID andvendor ID

pci irq routing options()

Retrieve PCI IRQ routing information

pci map irq() Map an interrupt pin to an IRQ

pci present() Determine whether or not PCI BIOS is present

pci read config()

Read from the configuration space of a PCI device



pci read config8()

Read a byte from the configuration space of adevice

pci read config16()

Read 16-bit values from the configuration space ofa device

pci read config32()

Read 32-bit values from the configuration space ofa device

pci rescan bus() Rescan the PCI bus for added or removed devices

pci write config()

Write to the configuration space of a PCI device

pci write config8()

Write bytes to the configuration space of a PCIdevice

pci write config16()

Write 16-bit values to the configuration space of adevice

pci write config32()

Write 32-bit values to the configuration space of adevice

hwi find item() Find an item in the hwi item structure

hwi find tag() Find a tag in the hwi item structure

hwi off2tag() Ret

c library reference - qnxfusion.qnx.com/0/11960/nto_lib_ref.pdf?tid=2704107_bo_0611030107&... ·...

Documents