Index

A

acknowledgment message	40
adjmsg	350
allocb	351
assembly programming	7
asynchronous input/output
.....in polling	116
asynchronous protocol Stream
.....example	46 to ??
audience intended	1
autopush	34

B

back-enable of a queue	78
back-enabling	78
background job
.....in job control	119
backq	351
bcanput	351
bidirectional transfer
.....example	146 to 151
bufcall	352, 368

C

canonical processing	47
canput	352
character I/O	9
character processing	47
cloning (STREAMS)	195
close
.....dismantling the Stream	35
connld(7)	256
controlling terminal	123
copyb	353
copymsg	353
copyreq structure	325
copyresp structure	326

D

datamsg	354
device
.....close	9
.....open	9
difference between driver & module	38
downstream
.....definition	8
driver	6
.....classification	182
.....ioctl control	39
.....overview	181 to 184
.....STREAMS	184 to ??

.....writing a driver	182 to ??
driver STREAMS	18
dupb	354
dupmsg	354

E

ECHOCTL	262
enableok	355
entry point address	31
esballoc	355
EUC handling in ldterm(7)	265
expedited data	55, 156
extended STREAMS buffers	105 to ??
.....allocation	106
.....freeing	106

F

fattach(3C)	251
fdetach(3C)	252
FIFO (STREAMS)	245
.....basic operations	246 to 249
.....flush	250
.....queue scheduling	45
file descriptor	9
file descriptor passing	253
flow control	76 to 81
.....definition	11
.....in driver	194
.....in line discipline module	176
.....in module	175 to 176
.....routines,?? to81
flush handling
.....description	153 to 155
.....flags	153, 342
.....in driver	190
.....in line discipline	155
.....in pipes and FIFOs	250
.....priority band data	156
.....read-side example	154
.....write-side example	154
flushband	356
flushq	356
foreground job
......in job control	119
freeb	356
freemsg	357
full-duplex processing	5

G

getmsg(2)	61
getpmsg function	63
getq	357
grantpt(3C)	281
......with pseudo-tty driver	277

H

hardware emulation module	268 to 270

I

I_SWROPT	248
infinite loop
......service procedure	46
input/output polling	111 to 117
insq	358
iocblk structure	325
......with M_IOCTL	331
ioctl I_SWROPT	248
ioctl(2)
......I_POP	35
......I_PUSH	35
......TIOCREMOTE	276
......TIOCSIGNAL	280
ioctl(2)
......general processing	132 to 133
......handled by ptem(7)	273
......hardware emulation module	269
......I_ATMARK	70
......I_CANPUT	70
......I_CKBAND	69
......I_GETBAND	69
......I_LINK	216, 331
......I_LIST	151
......I_PLINK	331

.....I_PUNLINK	331
.....I_RECVFD	253, 334
.....I_SENDFD	253, 334
.....I_SETSIG events	117
.....I_STR	40, 331
.....I_STR processing	134 to 135
.....I_UNLINK	221, 331
.....supported by ldterm(7)	264
.....supported by master driver	279
.....transparent	135 to 151
isastream(3C)	253

J

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

K

kernel thread	45

L

ldterm(7)	261
LIFO
.....module add/remove	38
line discipline module
.....close	262
.....description	261 to 268
.....in job control	121
.....in pseudo-tty subsystem	271
.....ioctl(2)	264
.....open	262
link editing	7
linkb	358
linkblk structure	327
linked list	30
lower multiplexer	20

M

M_BREAK	329
M_COPYIN	340
.....transparent ioctl example	139 to 143
M_COPYOUT	341
......transparent ioctl example	143 to 146
......with M_IOCTL	333
M_CTL	330
......with line discipline module	261
M_DATA	14, 330
M_DELAY	330
M_ERROR	341
M_FLUSH	342
......flags	342
......in module example	173
......packet mode	277
M_HANGUP	343
M_IOCACK	344
......with M_COPYOUT	341
......with M_IOCTL	332
M_IOCDATA	344
M_IOCNAK	345
......with M_COPYOUT	341
......with M_IOCTL	332
M_IOCTL	331 to 334
......transparent	332
......with M_COPYOUT	341
M_PASSFP	334
M_PCPROTO	14, 346
M_PCRSE	346
M_PCSIG	346
M_PROTO	14, 334 to 335
M_READ	346
M_RSE	335
M_SETOPTS
......SO_READOPT options	64
M_SETOPTS	336 to 339
......SO_FLAG	336 to 339
......SO_WROFF value	65
......with ldterm(7)	262
M_SIG	339
......in signaling	118
M_START	347
M_STARTI	347
M_STOP	347
M_STOPI	347
manipulating modules	24

master driver
.....in pseudo-tty subsystem	270
.....open	277
message (STREAMS)	13
.....allocation	99
.....control information	14, 94
.....definition	8
.....freeing	100
.....handled by pckt(7)	276
.....handled by ptem(7)	273
.....high priority	54, 340 to 347
.....ldterm(7) read side	263
.....ldterm(7) write side	264
.....linkage	57
.....M_DATA	14
.....M_PCPROTO	14
.....M_PROTO	14
.....ordinary	54, 329 to 340
.....processing	75
.....put back on queue	46
.....recovering from allocationfailure	102
.....sending/receiving	59
.....service interface	82 to 94
.....structures	56, 324 to 325
.....types	13, 53
message block (STREAMS)	8
.....linkage	57
message processing routines(STREAMS),?? to46
.....design guidelines	162 to 164
message queue (STREAMS)
.....priority	15, 66 to 70
minor device	9
module	16 to 18
.....control information	6
.....definition	6
.....difference with driver	38
.....draining	36
.....inserting	36
.....insertion	7
.....ioctl control	39
.....manipulation	24
.....pushed	8
.....reusability	26
......status information	6
MORECTL	94
MOREDATA	94
msgdsize	359
multiplexer
......building	212 to 220
......controlling Stream	217
......data routing	222
......declarations	229
......definition	19
......design guidelines	243
......driver	228 to 238
......example	225 to 227
......lower	211
......lower connection	223 to 224
......lower disconnection	224
......lower read put procedure	237 to 238
......lower write service procedure	236
......upper	211
......upper write put procedure	232 to ??
......upper write service procedure	235
multiplexer ID
......in multiplexer building	216
......in multiplexer dismantling	221
multiplexing STREAMS	18 to 23

N

named pipe (see FIFO)	245
named Stream
......description,?? to253
......fattach(3C)	251
......fdetach(3C)	252
......file descriptor passing	253
......isastream(3C)	253
......remote	254
noenable	359
NSTRPUSH	35

O

O_NDELAY	36
......with M_SETOPTS	338
O_NONBLOCK	36
......with M_SETOPTS	338

open
.....device file	33
organization of guide	1
other documentation	4
OTHERQ	359

P

packet mode
.....description	276
.....messages	276
pckt(7)	276
PIPE_BUF	249
pipemod STREAMS module	250
pipes	6
.....STREAMS (see STREAMS-basedpipe)	245
point-to-point	9
pollfd structure	114
polling
.....error events	115
.....events	112
.....example	113 to 116
priority band data	55, 156
.....flush handling example	156
.....ioctl(2)	69
.....routines	68
processing
.....canonical	47
.....character	47
.....read-side	49
protcol
.....migration	25
protocol
.....portability	24
.....substitution	25
pseudo-device driver	20
pseudo-tty emulation module	272 to 276
pseudo-tty subsystem	270
.....description	270 to 282
.....drivers	277 to 280
.....ldterm(7)	271
.....messages	273
......packet mode	276
......remote mode	276
ptem structure	275
ptem(7)	272, 275
ptm (see master driver)	270
pts (see slave driver)	270
ptsname(3C)	281
......with pseudo-tty driver	278
pullupmsg	359
put procedure	13, 44
putbq	360
putctl	360
putctl1	361
putmsg(2)	60
putpmsg function	62
putq	362

Q

qenable	363
qreply	363
qsize	364
queue	8, 12
......data structures	31
......limits	33
......pairs	8

R

RD	364
read side
......definition	8
......ldterm(7) messages	263
......ldterm(7) processing	263
......put procedure	168
read-side processing	49
releasing callback requests	105
rmvb	364
rmvq	364

S

SAD (see STREAMS AdministrativeDriver)	395
scheduler
.....STREAMS	45
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
.....infinite loop	46
service provider	85
.....accessing	88
.....closing	91
.....receiving data	92
.....sending data	91
signal(2)	111
signals
.....extended	118
.....in job control management	121
.....in STREAMS	118
slave driver
.....in pseudo-tty subsystem	270
.....open	278
SO_FLAG
.....in M_SETOPTS	336 to 339
stdata
.....data structure	34
strapush structure	395
strbuf structure	61
strchg(1)	151
strconf command	151
STRCTLSZ parameter	394
Stream
.....controlling terminal	122
.....hung-up	122
.....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 definition	5
Stream head
......definition	5
......intercepting I_STR	40
......processing control	64
STREAMS	3
......basic operations	9 to 12
......configuration	381 to 397
......manual pages	399
......mechanisms	29
......message queues	14
......system calls	9, 29
......tunable parameters	393 to ??
STREAMS Administrative Driver	395 to 397
STREAMS benefits	23 to 27
STREAMS components	12 to 18
STREAMS data structures	321 to 327
......design	165
......dynamic allocation	165
STREAMS debugging	376 to 379
......error and trace logging	377 to 379
STREAMS definition	5
STREAMS driver	18, 184 to ??
......cloning	195
......close routine design	161
......declarations	126
......definition	6
......design guidelines	160 to ??, 209
......environment	125
......flow control	194
......flush handling	190
......ioctl(2)	130 to 152
......loop-around	198 to ??
......open routine design	161
......printer driver example	187 to ??
......pseudo-tty	277 to 280
......pseudo-tty subsystem master	270
......pseudo-tty subsystem slave	270
STREAMS message queues	14
......priority	15 to 16

STREAMS module	16 to 18, 167 to 175
.....autopush facility	394, 397
.....close routine design	161
.....connld(7)	256
.....control information	6
.....declarations	126
.....definition	6
.....design guidelines	160 to ??, 178
.....environment	125
.....filter	171
.....flow control	175 to ??
.....ioctl(2)	130 to 152
.....line discipline	261
.....null module example	128
.....open routine design	161
.....ptem(7)	272
.....read side put procedure	168
.....routines	167 to 171
.....service interface example	94 to 99
.....service procedure	170
.....status information	6
.....write side put procedure	169
STREAMS multiplexing	18 to 23
STREAMS queue
.....definition	8
.....flags	72, 73
.....overview	12
.....qband structure	72
.....queue structure	70
.....structures	322 to 324
.....using equeue information	73
.....using qband information	73
STREAMS scheduler	45
.....in service procedure	45
STREAMS utility routines	349 to 367
STREAMS-based pipe	6
.....atomic write	249
.....basic operations	246 to 249
.....creation	34
.....creation errors	246
.....definition	245
.....PIPE_BUF	249
STREAMS-based pseudo-terminalsubsystem (see pseudo-ttysubsystem)	270
STREAMS-based terminal subsystem (seetty subsystem)	259
strioctl structure	40, 326
strlog	365
STRMSGSZ parameter	394
stroptions structure	327
strqget	365
strqset	366
synchronous input/output
......in polling	112

T

termio(7)	121
......default flag values	261
testb	366
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	259
......description	259 to 270
......hardware emulation module	268 to 270
......ldterm(7)	261
......setup	260

U

unbufcall	366, 369
unique connection (STREAMS)	254 to 257
unlinkb	367
unlockpt(3C)	281
......with pseudo-tty driver	278
upper multiplexer	20
upper Stream	19
upstream
......definition	8

W

WR	367
write side
.....definition	8
.....ldterm(7)	264
.....put procedure	169