Skip to ContentSun and Oracle Channel Sun How to Buy Log In

STREAMS Programming Guide

Contenues dans

Solaris 2.5 Supplemental Developer AnswerBook

Trouver plus de documentation

Ressources d'assistance comprises

Télécharger cet ouvrage au format PDF

Index

A


acknowledgment message	40
adjmsg	352
allocb
.....example use of	100
allocb	353
ASCII translation	47
assembly programming	7
asynchronous input/output
.....in polling	116
asynchronous protocol Stream
.....example	46 to 52
atomic writes	251
audience intended	1
autopush	34

B


b_band	56
.....placement	57
b_next	56
back-enable of a queue	78
back-enabling	78
background job
.....in job control	119
background process group
.....in job control	119
backq	353
bandp example	63
bcanput	353
bidirectional transfer
.....example	146 to 151
blocked process	116
bufcall	354

C


canonical processing	47
canput	354
character I/O	9
character processing	47
cloning (STREAMS)	195
close
.....delayed	36
.....dismantling the Stream	35
close system call	9, 30
closing a Stream	35
connld failure	258
connld(7)	258
control,Stream head processing	64
controlling process
.....in job control	119
controlling terminal	119 to 123
.....accessing	123


.....denial of access	123
.....in job control	119
copyb	355
copymsg	355
copyreq structure	327
copyresp structure	328

D


data structure
.....stdata	34
datab structure	57
datab(9S) data structure	13
datamsg	356
db_base	57
deferred	45
delay
.....closing STREAMS	36
device
.....close	9
.....open	9
difference between driver & module	38
downstream
.....definition	8
driver
.....classification	182
.....declarations	126
.....definition	6, 18
.....ioctl control	39
.....overview	181 to 184
.....STREAMS	184 to 209
.....writing a driver	182
dupb	356
dupmsg	356

E


EBCDIC translation	47
ECHOCTL	264
enableok	357
entry point address	31
error messages
.....pipes	248
esballoc	107
esballoc	357
EUC handling in ldterm(7)	267
expedited data	55, 156
extended STREAMS buffers	105 to 107
......allocation	106
......freeing	106

F


fattach(3C)	253
fdetach(3C)	254
FIFO	250
......flushing	252
......reading from	249
FIFO (STREAMS)	247
......basic operations	248 to 251
......flush	252
......queue scheduling	45
FIFO closing	251
file descriptor	9
file descriptor passing	255
flow control	76 to 81
......definition	11
......example	81
......expedited data	79
......in driver	194
......in line discipline module	177
......in module	176 to 177
......routines	76 to 81
flush handling
......description	153 to 155
......flags	153, 344
......in driver	190
......in line discipline	155
......in pipes and FIFOs	252
......priority band data	156
......read-side example	154
......write-side example	154
flushband	358
flushq	358
foreground job
......in job control	119
foreground process group


.....in job control	120
free routine	107
freeb	358
freemsg	359
freezestr	359
full-duplex processing	5

G


getmsg system call	30
getmsg(2)	61
getpmsg function	63
getpmsg system call	30
getq	359
getstrm	47
grantpt(3C)	283
.....with pseudo-tty driver	279

H


hangup signals	122
hardware emulation module	270 to 272
high water,
.....low water	55
high-priority messages	67
hung-up Stream	122

I


I_CKBAND	69
I_GETBAND	69
I_SETSIG ioctl(2)	111
I_STR	40
I_SWROPT	250
infinite loop
.....service procedure	46, 67
input/output polling	111 to 117
insq	360
iocblk structure	327
.....with M_IOCTL	333
ioctl
.....I_FLUSHBAND	69
ioctl
......I_PUSH	35
ioctl I_SWROPT	250
ioctl system call definition	30
ioctl(2)
......I_POP	35
......TIOCREMOTE	278
......TIOCSIGNAL	282
ioctl(2)
......general processing	132 to 133
......I_LIST	151
......I_SETSIG events	117
......I_STR	40
......I_STR processing	134 to 135
......transparent	135 to 151
ioctl(2)
......handled by ptem(7)	275
......hardware emulation module	271
......I_ATMARK	70
......I_CANPUT	70
......I_CKBAND	69
......I_GETBAND	69
......I_LINK	216, 333
......I_PLINK	333
......I_PUNLINK	333
......I_RECVFD	255, 336
......I_SENDFD	255, 336
......I_STR	333
......I_UNLINK	221, 333
......supported by ldterm(7)	266
......supported by master driver	281
isastream(3C)	255

J


job control	119 to 122
......terminology	119 to 120

K


kernel thread	45

L


ldterm(7)	263
LIFO


.....module add/remove	38
line discipline module
.....close	264
.....description	263 to 270
.....in job control	121
.....in pseudo-tty subsystem	273
.....ioctl(2)	266
.....open	264
link editing	7
linkb	361
linkblk structure	329
linked queues	30
linking messages	56
lower multiplexer	20

M


M_BREAK	331
M_COPYIN
.....transparent ioctl example	139 to 143
M_COPYIN	342
M_COPYOUT
.....transparent ioctl example	143 to 146
M_COPYOUT	343
.....with M_IOCTL	335
M_CTL	332
.....with line discipline module	263
M_DATA
.....example	52
M_DATA	14
M_DATA	332
M_DELAY	332
M_ERROR	343
M_FLUSH	344
.....flags	344
.....in module example	174
.....in pipemod	252
.....packet mode	279
M_HANGUP	345
M_IOCACK	346
.....with M_COPYOUT	343
.....with M_IOCTL	334
M_IOCDATA	346
M_IOCNAK	347
......with M_COPYOUT	343
......with M_IOCTL	334
M_IOCTL
......example	52
M_IOCTL	333 to 336
......transparent	334
......with M_COPYOUT	343
M_PASSFP	336
M_PCPROTO	14
M_PCPROTO	348
M_PCRSE	348
M_PCSIG	348
M_PROTO	14
M_PROTO	336 to 337
M_READ	348
M_RSE	337
M_SETOPTS
......SO_READOPT options	64
M_SETOPTS	65, 338 to 341
......SO_FLAG	338 to 341
......with ldterm(7)	264
M_SIG
......in signaling	118
M_SIG	341
M_START	349
M_STARTI	349
M_STOP	349
M_STOPI	349
manipulating modules	24
master driver
......in pseudo-tty subsystem	272
......open	279
mechanism
......STREAMS overview	29
mechanism,STREAMS overview	29
memory-mapped I/O	105
message	44
......priorities	66
......priority	90
......queues	66
message (STREAMS)	13


.....allocation	99
.....control information	14, 94
.....definition	8
.....direction	60
.....flow	75
.....freeing	100
.....handled by pckt(7)	278
.....handled by ptem(7)	275
.....high priority	54, 342 to 349
.....ldterm(7) read side	265
.....ldterm(7) write side	266
.....linking into queues	56
.....M_DATA	59
.....M_DATA	14
.....M_PCPROTO	59
.....M_PCPROTO	14
.....M_PROTO	59
.....M_PROTO	14
.....ordinary	54, 331 to 342
.....processing	75
.....put back on queue	46
.....recovering from allocationfailure	102
.....sending/receiving	59
.....service interface	82 to 94
.....structures	56 to 57, 326 to 327
.....types	13, 53
.....write offset value	65
message block (STREAMS)	8
message copy	67
message ordering	59
message priorities	66
message processing	45
message processing routines(STREAMS)	43 to 46
.....design guidelines	162 to 164
message queue (STREAMS)
.....priority	15, 66 to 70
messages
.....high-priority	67
.....zero-length	250
minor device	9
module	16 to 18
.....character conversion	39
......CHARPROC example	50
......control information	6
......declarations	126
......definition	6, 18
......difference with driver	38
......draining	36
......inserting	36
......insertion	7
......ioctl control	39
......manipulation	24
......null example	128
......order of adding	38
......pushable example	48
......reusability	26
......status information	6
module,adding	35
module,CANONPROC example	51
module,removing	35
module_info structure	31
module_stat structure	31
monitor
......multiple Streams	116
monitoring a Stream	111
MORECTL	94
MOREDATA	94
msgb(9S) data structure	13
msgdsize	361
msgpullup	361
multiplexer
......building	212 to 220
......controlling Stream	217
......data routing	222
......declarations	229
......definition	19
......design guidelines	244
......driver	228 to 239
......example	225 to 227
......lower	211
......lower connection	223 to 224
......lower disconnection	224
......lower read put procedure	237 to 239
......lower write service procedure	237
......upper	211
......upper write put procedure	232 to 235


.....upper write service procedure	236
multiplexer ID
.....in multiplexer building	216
.....in multiplexer dismantling	221
multiplexing STREAMS	18 to 23

N


named pipe (see FIFO)	247
named Stream
.....description	252 to 255
.....detaching	254
.....error	256
.....fattach(3C)	253
.....fdetach(3C)	254
.....file descriptor	255
.....file descriptor passing	255
.....isastream(3C)	255
.....remote	256
named Streams
.....path	253
noenable	361
NSTRPUSH	35

O


O_NDELAY	36
O_NDELAY
.....with M_SETOPTS	340
O_NDELAY flag	116
O_NONBLOCK	36
O_NONBLOCK
.....with M_SETOPTS	340
O_NONBLOCK flag	116
open
.....device file	33
open system call	9
opening a Stream	33
opensystem call	30
organization of guide	1
orphaned process group
.....in job control	120
other documentation	4
OTHERQ	361
overview
......STREAMS mechanism	29

P


packet mode
......description	278
......messages	278
panic	59
passing	44
passing messages	44
path
......in named Streams	253
pckt(7)	278
pipe
......adding modules to	248
......bidirectional	247
......closing	251
......creating	248
......definition	6, 247
......errors	248
......flushing	252
......reading from	249
......writing to	250
pipe creation	34
pipe system call	30
PIPE_BUF	251
pipemod STREAMS module	252
pipes
......STREAMS (see STREAMS-basedpipe)	247
point-to-point	9
poll system call	30
pollfd structure	114
POLLIN	112
polling
......error events	115
......events	112
......example	113 to 116
POLLOUT	112
POLLPRI	112
POLLRDBAND	112


POLLRDNORM	112
POLLWRBAND	112
POLLWRNORM	112
priority band data	55, 156
.....flush handling example	156
.....ioctl(2)	69
.....routines	68
priority band,example	63
priority bands	66
process groub
.....in job control	120
process group leader
.....in job control	120
process group lifetime
.....in job control	120
process ID
.....in job control	120
process lifetime
.....in job control	120
processing
.....canonical	47
.....character	47
.....read-side	49
protocol
.....migration	25
.....portability	24
.....substitution	25
protocol messages,read	65
pseudo-device driver	20
pseudo-tty emulation module	274 to 278
pseudo-tty subsystem	272
.....description	272 to 284
.....drivers	279 to 282
.....ldterm(7)	273
.....messages	275
.....packet mode	278
.....remote mode	278
ptem structure	277
ptem(7)	274, 277
ptm (see master driver)	272
pts (see slave driver)	272
ptsname(3C)	283
.....with pseudo-tty driver	280
pullupmsg	362
pushable module,example	48
put	362
put procedure	13, 44
putbq	362
putctl	363
putctl1	363
putmsg equivalents	62
putmsg system call	30
putmsg(2)	60
putnext	363
putpmsg function	62
putpmsg system call	30
putq	364

Q


q_next	33
qband structure	31, 72
qbufcall	370
qenable	365
qinit structure	31, 34
qprocson	365
qreply	366
qsize	366
qtimeout	370
queue
......data structures	31
......definition	8
......entry point	31
......flags	72
......initializing	33
......limits	33
......overview	12
......pairs	8
......routines	43
......usingqband information	73
queue pairs	30
queue structure	70
qunbufcall	371
quntimeout	371
qwriter	372

R


RD	366
read options
.....Stream head	64
read side
.....definition	8
.....ldterm(7) messages	265
.....ldterm(7) processing	265
.....put procedure	168
read system call	9, 30
read-side processing	49
releasing callback requests	105
RMODEMASK	64
RMSGD	64
RMSGN	64
rmvb	366
rmvq	367
RNORM	64
RPROTDAT	65
RPROTDIS	65
RPROTMASK	65
RPROTNORM	65

S


SAD (see STREAMS AdministrativeDriver)	397
scheduler
.....STREAMS	45
scheduler delay	66
service interface	23, 83 to 85
.....definition	82
.....library example	86 to 94
.....rules	94
service primitive	85
.....in service procedure	87
service procedure	13, 45, 80
.....implementation	46
.....infinite loop	46
service provider	85
.....accessing	88
.....closing	91
......receiving data	92
......sending data	91
session
......in job control	120
session ID
......in job control	120
session leader
......in job control	120
session lifetime
......in job control	120
SIGHUP	122
signal(2)	111
signals	118
......extended	118
......in job control management	121
......in STREAMS	118
slave driver
......in pseudo-tty subsystem	272
......open	280
SO_FLAG
......in M_SETOPTS	338 to 341
SO_WROFF value	65
st_muxrinit	34
st_muxwinit	34
st_rdinit	34
st_wdinit	34
stdata
......data structure	34
strapush structure	397
strbuf structure	61
strchg(1)	151
strconf command	151
STRCTLSZ parameter	396
Stream
......controlling terminal	122
......definition	5
......hung-up	122
......monitoring	111
......simple	5
Stream construction	5, 30 to 36
......add/remove modules	35
......close a Stream	35
......define module/driver	33


.....example	36 to 41
.....open a Stream	33
.....queue structures	31
Stream head
.....definition	5
.....intercepting I_STR	40
.....processing control	64
.....read options	64
STREAMS
.....basic operations	9 to 12
.....configuration	383 to 399
.....manual pages	401
.....mechanisms	29
.....system calls	9
.....tunable parameters	395
.....typographic convention	3
STREAMS Administrative Driver	397 to 399
STREAMS benefits	23 to 27
STREAMS components	12 to 18
STREAMS data structures	323 to 329
.....design	165
.....dynamic allocation	165
STREAMS debugging	378 to 381
.....error and trace logging	379 to 381
STREAMS definition	5
STREAMS driver	184 to 195
.....cloning	195
.....close routine design	161
.....declarations	126
.....definition	6, 18
.....design guidelines	160 to 164, 209
.....environment	125
.....flow control	194
.....flush handling	190
.....ioctl(2)	130 to 152
.....loop-around	198 to 209
.....open routine design	161
.....printer driver example	187 to 190
.....pseudo-tty	279 to 282
.....pseudo-tty subsystem master	272
.....pseudo-tty subsystem slave	272
STREAMS message queues	14
.....priority	15 to 16
STREAMS module	16 to 18, 167 to 176
......autopush facility	396, 399
......close routine design	161
......connld(7)	258
......control information	6
......declarations	126
......definition	6
......design guidelines	160 to 164, 179
......environment	125
......filter	172
......flow control	176 to 179
......ioctl(2)	130 to 152
......line discipline	263
......null module example	128
......open routine design	161
......ptem(7)	274
......read side put procedure	168
......routines	168 to 172
......service interface example	94 to 99
......service procedure	171
......status information	6
......write side put procedure	169
STREAMS multiplexing	18 to 23
STREAMS queue
......definition	8
......flags	72, 73
......qband structure	72
......queue structure	70
......structures	324 to 326
......using equeue information	73
......using qband information	73
STREAMS scheduler	45
......in service procedure	45
STREAMS system calls	30
STREAMS utility routines	351 to 369
STREAMS-based pipe	6
......atomic write	251
......basic operations	248 to 251
......creation	34
......creation errors	248
......definition	247
......PIPE_BUF	251
STREAMS-based pseudo-terminalsubsystem (see pseudo-ttysubsystem)	272


STREAMS-based terminal subsystem (seetty subsystem)	261
streamtab structure	34
strioctl structure	40
strioctl structure	328
strlog	367
STRMSGSZ parameter	396
stroptions structure	329
strqget	68
strqget	368
strqset	69
strqset	368
synchronous input/output
.....in polling	112
system calls, STREAMS	30
system crash	59

T


terminal options
.....STREAMS example	47
termio(7)	121
termio(7)
.....default flag values	263
testb	368
thread
.....service procedure	45
transparent ioctl
.....M_COPYIN example	139 to 143
.....M_COPYOUT example	143 to 146
.....messages	138
.....processing	135 to 151
tty subsystem
.....benefits	261
.....description	261 to 272
.....hardware emulation module	270 to 272
.....ldterm(7)	263
.....setup	262

U


unbufcall	369
unique connection (STREAMS)	256 to 259
unlinkb	369
unlockpt(3C)	283
......with pseudo-tty driver	280
upper multiplexer	20
upper Stream	19
upstream
......definition	8

W


watermarks	55
WR	369
write
......less than requested	116
write offset in messages	65
write side
......definition	8
......ldterm(7)	266
......put procedure	169
write system call	9, 30
writing to	250

Z


zero-length messages	250