Index

Symbols

% preprocessing directive	36
&, server invocation and	30

Numerics

_1 suffix	27, 63

A

access control
.....authentication vs.	99
.....port monitors and	304
add.x source file	38, 39 to 41, 45 to 48, 49
adding
.....address registrations	18
.....NIS+ database entries	156
.....NIS+ group members	155
.....NIS+ objects to namespace	154
.....NIS+ table entry objects	154, 164 to 165
.....port monitor services	311
.....port monitors	302
.....two numbers	286
ADDPROG program	286
addresses
.....information reporting for	20
.....lookup services	15, 18, 19
.....management functions	141
.....mapping RPC services to,Seeportmap routine;rpcbindroutine
.....name-to-address translationroutines	17 to 18, 19, 137
.....network	295 to 296
.....overview	295 to 296
.....passing arguments as	26 to 27, 63
.....passing server's address to client	76
.....passing user's bind address	79
.....registering,Seeportmap routine;rpcbind routine
.....transport (netbuf)	18, 247
.....universal	17 to 18, 246, 247, 296, 333
.....unregistering
............current vs. previous release	140
............portmap routine	299
............rpcbind routine	18, 243, 246
............rpcinfo routine	20
ah_cred field	83
ah_key field	100
ah_verf field	83
allocating memory,See memory
ampersand (&), server invocation and	30
ANSI C standards
.....rpcgen tool and	23, 37, 49
application programming interface (API)

.....NIS+	153 to 157
applications
.....porting from TS-RPC to TI-RPC	136
arguments (remote procedures)
.....overview	11
.....passing arbitrary data types	64 to 67
.....passing by address	26 to 27, 63
.....passing by value	39 to 41
.....passing open TLI file descriptors	76, 79
.....passing server's address to client	76
.....passing user's bind address	79
.....void	238
arrays
.....See also data structures
.....converting to XDR format	66 to 67, 134 to 135
.....declarations
............RPC language	234 to 235
............XDR language	261 to 262, 270
.....XDR code examples	189 to 192, 193 to 194
assign configuration-scriptkeyword	318
asynchronous mode	88 to 90
AUTH_BADCRED error	227, 228
AUTH_BADVERF error	227
AUTH_DES authentication	99 to 101, 220 to 226
.....common key	225 to 226
.....conversation key	221 to 222, 223 to 224, 226
.....credentials	100, 223 to 224
.....described	96, 99 to 100, 220 to 221
.....Diffie-Hellman encryption	100, 222, 225 to 226
.....errors	223
.....handle	99 to 100
.....nicknames	222 to 223, 224 to 225
.....protocol in XDR language	223 to 226
.....server	100 to 101
.....time synchronization	100, 222 to 223
.....verifiers	221 to 222, 224 to 225
auth_destroy routine	96
AUTH_KERB authentication	102 to 104, 226 to 230
......credentials	102, 103, 104, 227 to 229
......described	96, 102 to 104, 226
......encryption	103 to 104
......errors	227 to 228
......NFS and	226 to 228
......nicknames	103 to 104, 227, 228 to 229, 230
......protocol in XDR language	228 to 230
......time synchronization	102, 229, 230
......verifiers	103, 104, 228, 229 to 230
AUTH_NONE authentication	96, 97, 218
AUTH_REJECTEDCRED error	219, 227
AUTH_REJECTEDVERF error	228
AUTH_SHORT authentication	96
AUTH_SHORT verifier	219 to 220
AUTH_SYS authentication	96, 97 to 99, 218 to 220
AUTH_TIMEEXPIRE error	228
AUTH_TOOWEAK error	228
AUTH_UNIX (AUTH_SYS)authentication	218 to 220
AUTH_UNIX (AUTH_SYS)authentication	96, 97 to 99
authdes_create routine	141
authdes_seccreate routine	100, 141
authentication	95 to 104, 218 to 230
......access control vs.	99
......allocating authenticationnumbers	218
......AUTH_DES	96, 99 to 101, 220 to 226
......AUTH_KERB	96, 102 to 104, 226 to 230
......AUTH_NONE	96, 97, 218
......AUTH_SHORT	96, 219 to 220
......AUTH_SYS (AUTH_UNIX)	218 to 220
......AUTH_SYS (AUTH_UNIX)	96, 97 to 99
......credentials
............AUTH_DES	100, 223 to 224
............AUTH_KERB	102, 103, 104, 227 to 229
............described	211 to 212
............window (lifetime) of	100, 102, 222, 223 to 224, 229

.....current vs. previous release	141
.....destroying an	96
.....errors
............AUTH_DES	223
............AUTH_KERB	227 to 228
............AUTH_SYS	99, 219
.....handles	83, 99 to 100
.....low-level data structures and	83
.....methods supported	96
.....nicknames
............AUTH_DES	222 to 223, 224 to 225
............AUTH_KERB	103 to 104, 227, 228 to 229, 230
.....NIS+	151
.....overview	95 to 96, 218
.....registering authenticationnumbers	218
.....RPC protocol and	211 to 212
.....rpcgen tool and	51, 54
.....servers	96 to 97, 98 to 99, 100 to 101
.....service-dispatch routine and	96 to 97
.....time synchronization
............AUTH_DES authentication	100, 222 to 223
............AUTH_KERB authentication	102, 229, 230
.....verifiers
............AUTH_DES	221 to 222
............AUTH_KERB	103, 104, 228, 229 to 230
............AUTH_SYS	219 to 220
............described	211 to 212
authkerb_seccreate routine	102
authorization
.....See also authentication
.....NIS+	151
authsys_create routine	99, 141
authsys_create_default routine	99, 141
authunix_create routine	141
authunix_create_defaultroutine	141
Automatic MT mode,See MT Auto mode

B

batching	92 to 95, 213, 291 to 294
bcast.c program	90 to 91
bcast_proc routine	91 to 92
binding
......See alsorpcbind routine
......dynamic	296
......TI-RPC and	11, 210
booleans
......RPC language	239
......XDR language	255
bottom level interface routines (RPC)	15, 80 to 82
broadcast RPC	90 to 92
......current vs. previous release	140 to 141
......overview	90, 214
......portmap routine and	297, 300
......routines for	13, 90 to 92
......rpcbind routine and	240, 248
......server response to	50, 52, 91, 92
......TS-RPC vs. TI-RPC	143 to 145
buffer size
......specifying send and receive	76, 79
byte arrays
......See also arrays
......XDR	189

C

C
......rpcgen tool and
............ANSI C compliance	23, 37, 49
............C-style mode	22, 37, 39 to 41, 238
............preprocessing directives	35 to 37, 50, 51
............SPARCompiler C++ 3.0compatibility	49
......XDR routines and	175
caching
......NIS+	153
......server	82
call semantics
......TI-RPC	12, 209

callback procedures
.....NIS+	166, 168
.....transient RPC program numbersand	109 to 110
.....uses for	109 to 110
callrpc routine	140
CBC (cipher block chaining) mode	103
cd command	319
changing
.....NIS+ objects in namespace	154
.....NIS+ table entry objects	154
.....port monitor configurationscripts	319 to 321
.....port monitor services	311
.....version numbers of programs	106
cipher block chaining (CBC) mode	103
circuit_n transport type	16
circuit_v transport type	16
circuit-oriented transports
.....when to use	17
cl_auth field	83, 96
cl_netid field	80 to 81
cl_private field	81
cl_tp field	80 to 81
classes of messages	309
client authentication,See authentication
client handles
.....creating
............bottom level interface	15, 81
............current vs. previous release	139
............expert level interface	15, 76 to 78
............intermediate level interface	14, 73 to 74
............top level interface	14, 28 to 29, 68 to 70
.....defined	331
.....destroying
............current vs. previous release	139
............expert level interface	78
............top level interface	28, 70
.....low-level data structures for	82 to 83
client programs
.....remote copy	132 to 133
......rpcgen tool and
............ANSI C-compliance	49
............complex data structurepassing	33 to 35
............debugging	56 to 57
............directory listing service	33 to 35, 284 to 285
............message printing codeexample	27 to 30
............MT-safety	22, 45 to 47
............overview	23, 27 to 30
......simplified interface	61 to 62
client stub routines
......rpcgen tool and	21, 28, 29
............C-style mode	40 to 41
............MT Auto mode	48
............MT-safe	42 to 43
............MT-unsafe	43 to 44
............preprocessing directive	36
client templates
......rpcgen tool	22, 37, 38, 39 to 41
client time-out periods
......creating timed clients	14, 70, 74
......rpcgen tool and	51, 53
clients
......batched	92 to 94, 291 to 292
......defined	331, 332
......multiple versions	108 to 109
......multithreaded
............overview	111 to 116
............safety	42 to 44, 45 to 47, 59, 332
............User mode	123, 124 to 126
......NIS+	153
......transaction IDs and	209
......TS-RPC vs. TI-RPC	142 to 143
_clnt.c suffix	29
clnt_broadcast routine	140, 143 to 144
clnt_call routine
......current vs. previous release	140
......described	14, 15
......RPCPROGVERSMISMATCH error	108
......simplified interface and	68
......top level interface and	70
clnt_control routine

.....current vs. previous release	139
.....described	53, 78
.....simplified interface and	68
.....using	53
clnt_create routine
.....code example	27 to 29
.....current vs. previous release	139
.....described	14
clnt_create_timed routine
.....current vs. previous release	139
.....described	14
.....using	70
clnt_create_vers routine	108, 139
clnt_destroy routine
.....current vs. previous release	139
.....described	28, 70, 78
.....simplified interface and	68
clnt_dg_create routine
.....current vs. previous release	139
.....described	15, 81
.....using	81
clnt_ops field	81
clnt_pcreateerror routine
.....current vs. previous release	139
.....described	70
.....simplified interface and	68
clnt_perrno routine	68
clnt_perror routine	57, 68
clnt_raw_create routine	85 to 87, 139
clnt_spcreateerror routine	139
clnt_sperror routine	57
clnt_tli_create routine
.....current vs. previous release	139
.....described	15, 76, 80 to 81
.....using	76, 78
clnt_tp_create routine	14, 139
clnt_tp_create_timed routine
.....current vs. previous release	139
.....described	14
.....using	74
clnt_vc_create routine
.....current vs. previous release	139
.....described	15, 81
......using	81
clntraw_create routine	139
clnttcp_create routine	139
clntudp_bufcreate routine	139
clntudp_create routine	76 to 78, 139
clock synchronization,See timesynchronization
comments
......XDR language	267
compatibility
......library functions, current vs. previousrelease	139 to 142
compilation
......NIS+	158
......rpcgen tool	22, 39 to 41
complex data structures
......See also data structures
......packing withxdr_inline	37, 50
......rpcgen tool and	30 to 35
compound data type filters
......XDR	66 to 67, 187
_config file	315, 316, 317, 320, 330
configuration scripts,See port monitors,configuration scripts
connectionless transports
......See also datagram transports; UDP(user datagram protocol)
......client handle creation for	15
......defined	331
......nettype parameters for	16
......server handle creation for	15
connection-oriented endpoints	85
connection-oriented transports
......See also TCP (transport controlprotocol)
......client handle creation for	15
......defined	331
......nettype parameters for	16
......port monitors and	104 to 105
......remote copy code example	131 to 134
......server handle creation for	15
constants
......RPC language	233

.....XDR language	265, 267, 270
constructed data type filters
.....XDR	66 to 67, 187
conversation key
.....AUTH_DES authentication	221 to 222, 223 to 224, 226
converting
.....addresses	17 to 18, 19, 137
.....from XDR format	64, 67, 72, 134, 135, 181 to 182, 331
.....local procedures to remoteprocedures	23 to 30
.....to XDR format	30 to 35, 64 to 67, 134 to 135, 177 to 179, 181 to 182, 332
copying
.....NIS+ database entries	156
.....NIS+ objects	157
.....NIS+ table entry objects	154
.....remote	131 to 134
counted byte strings,See stringdeclarations; stringrepresentation
cpp directive
.....rpcgen tool and	37
crashes
.....server	209, 223
creating
.....client handles,See client handles,creating
.....NIS+ databases	155
.....NIS+ directory objects	162
.....NIS+ group objects	155, 163
.....NIS+ table objects	163 to 165
.....server handles,See server handles,creating
.....utmp entries	305, 312, 316
credentials
.....AUTH_DES	100, 223 to 224
.....AUTH_KERB	102, 103, 104, 227 to 229
.....described	211 to 212
.....window (lifetime) of	100, 102, 222, 223 to 224, 229
C-style mode
......rpcgen tool	22, 37, 39 to 41, 238

D

daemons
......kerbd	226, 227
......rpcbind	19, 90
data representation
......See also XDR (external datarepresentation)
......TI-RPC	12
data structures
......See also arrays; structure declarations
......converting to XDR format	30 to 35, 64 to 67, 134 to 135, 179, 181 to 182
......low-level	82 to 85
......MT safe	123
......packing withxdr_inline	37, 50
......recursive	203 to 206, 266
......rpcgen tool and	30 to 35
data types
......passing arbitrary	64 to 67
database access functions (NIS+)	153, 155, 156
datagram transports
......See also UDP (user datagram protocol)
......broadcast RPC and	90
......defined	331
......nettype parameters	16
......when to use	17
datagram_n transport type	16
datagram_v transport type	16
date service
......intermediate level client for	73 to 74
......intermediate level server for	74 to 75
......top level client for trivial	69 to 70
......top level server for	71 to 72
db_add_entry function	156
db_checkpoint function	156
db_first_entry function	156
db_list_entries function	156
db_next_entry function	156
db_remove_entry function	156

db_reset_next_entry function	156
db_standby function	156
dbxtool routine	56
deallocating memory,See memory,releasing
debugging
.....raw mode and	85 to 87
.....rpcgen tool and	50, 51, 56 to 57
declarations
.....RPC language	234 to 240
.....XDR language	253 to 266
defaults
.....maximum number of threads	119
.....rpcgen tool,Seerpcgen tool,defaults
.....single-threaded mode	117
define statements, command line,rpcgentool	50, 51
definitions
.....RPC language	231 to 232, 272
deleting
.....See also destroying; memory, releasing
.....address registrations	140
.....address registrations,Seeunregistering
.....assocations	15
.....mappings	15
.....NIS+ database entries	156
.....NIS+ directory from host	155
.....NIS+ group members	155
.....NIS+ group objects	155, 169 to 173
.....NIS+ objects from namespace	154, 168 to 169
.....NIS+ table entry objects	154, 169 to 173
.....port monitor services	311
.....port monitors	302
DES encryption	100, 103 to 104, 222, 225 to 226
deserializing	64, 67, 72, 134, 135, 181 to 182, 331
.....See also XDR (external datarepresentation)
destroying
......See also deleting
......client authentication handles	96
......client handles	28, 70, 78, 139
......NIS+ objects	157
......server handles	139
......XDR streams	198
Diffie-Hellman encryption	100, 222, 225 to 226
dir.x program	30 to 32, 281 to 282
dir_proc.c routine	32 to 33, 282 to 283
dir_remove function	170
directories
......remote directory listing service	30 to 35, 281 to 285
......SAF (service access facility)	329 to 330
disabling port monitors	304, 307
discriminated unions
......declarations
............RPC language	236 to 237
............XDR language	236 to 237, 263 to 264, 270
......XDR code samples	194 to 196
dispatch tables
......rpcgen tool	50, 55 to 56
doconfig function	305, 314, 316 to 317
domains (NIS+)
......administration commands	153
......functions	155, 157
......overview	149 to 150
dynamic binding	296
dynamic program numbers	109 to 110, 212

E

ECB (electronic code book) mode	103, 104
electronic code book (ECB) mode	103
enabling
......port monitors	304, 307
......server caching	82
encryption

.....AUTH_DES authentication (Diffie-Hellman)	100, 222, 225 to 226
.....AUTH_KERB authentication	103 to 104
endnetconfig routine	78
endpoints
.....connection-oriented	85
enumeration filters
.....XDR primitives	186 to 187
enumerations
.....RPC language	31, 232 to 233
.....XDR language	254 to 255
errors
.....authentication
............AUTH_DES	223
............AUTH_KERB	227 to 228
............AUTH_SYS	99, 219
.....client handle creation	70
.....multiple client version	108
.....NIS+ error message displayfunctions	153, 156
.....RPC	29, 56 to 57, 211
.....thr_create	119
/etc/inet/inetd.conf file	105
/etc/netconfig database	16, 51, 138
/etc/rpc database	12
/etc/saf/_pid file	305, 315, 322, 330
/etc/saf/pmtag directory	329
/etc/saf/pmtag/_config file	315, 316, 317, 320, 330
	315
/etc/saf/pmtag/_pmpipe file	307, 315, 330
/etc/saf/pmtag/_pmtab file	306, 311 to 312, 315, 330
/etc/saf/pmtag/svctag file	311 to 312, 315, 316, 330
/etc/saf/_sactab files	310, 329
/etc/saf/_sysconfig file	316, 317, 319 to 320, 329
expert level interface routines (RPC)	15, 75 to 80
......client	76 to 78
......overview	15, 75
......server	79 to 80
external data representation,See XDR(external data representation)

F

file data structure
......XDR language	270 to 271
file descriptors, passing open TLI	76, 79
file system,See NFS (network file system)
filters (XDR)
......arrays	189 to 192, 193 to 194
......constructed (compound) datatype	66 to 67, 187
......enumeration	186 to 187
......floating point	65, 186
......number	65 to 66, 185 to 186
......opaque data	192 to 193
......strings	67, 187 to 188
......unions	194 to 196
fixed-length arrays
......See also arrays
......declarations
............RPC language	234 to 235
............XDR language	261 to 262
......XDR code sample	193 to 194
fixed-length opaque data
......XDR language	258 to 259
flags,Seerpcgen tool, flags
floating point
......XDR language	256 to 258
floating point filters
......XDR primitives	65, 186
free routine	35
freeing resources
......See deleting; destroying; disablingport monitors; memory,releasing
freenetconfigent routine	74

G

getnetconfig routine	78
getnetconfigent routine	73, 74
glossary	331 to 333
groups (NIS+)
.....administration commands	152
.....manipulation functions	153, 155
.....sample programs	163, 169 to 173

H

hand-coded registration routine	64
handles
.....See also client handles; server handles;transport handles
.....authentication	83, 99 to 100
.....defined	331
header files
.....rpcgen tool and	29, 36
host/service pairs
.....translation to/fromnetbufaddresses	18
hosts
.....defined	332
hyper integers
.....XDR language	255 to 256

I

.i suffix	55
I/O streams
.....XDR	199
idempotent
.....defined	12
identifiers
.....XDR language	267
identifying
.....See also authentication; naming
.....port monitor services	311
.....remote procedures	12, 209, 210 to 213
index table
.....rpcgen tool and	36
indirect RPC	244, 245, 248
inetd port monitor
......RPC services	105
......rpcgen tool and	30, 52 to 53
......using	104, 105
inetd.conf file	105
information reporting
......addresses	20
......NIS+	155, 156
......remote host status	111 to 116
......RPC	20
......rpcbind server	248
......server callbacks	109 to 110
installing port monitor configurationscripts	319 to 321
integers
......XDR language	177 to 178
integers, XDR language	253 to 254, 255 to 256
interfaces,See RPC (remote procedurecall), interface routines; SAF(service access facility)
intermediate level interface routines(RPC)	14, 73 to 75
Internet protocols,See TCP (transportcontrol protocol); UDP (userdatagram protocol)
ISTATE environment variable	304, 306 to 307, 315

K

kerbd daemon	226, 227
Kerberos authentication,SeeAUTH_KERBauthentication
keywords
......RPC language	31
......XDR language	269
KGETKCRED procedure	226, 227
KGETUCRED procedure	226, 227 to 228
KSETKCRED procedure	226, 227

L

lib library	35

libc library	137, 138
libnsl library	29, 32, 137, 138
libraries
.....lib	35
.....libc	137, 138
.....libnsl	29, 32, 137, 138
.....librpcsvc	60
.....lthread	112
.....RPC functions	139 to 142
.....rpcgen tool and
............libnsl	29, 32, 137, 138
............selecting TI-RPC or TS-RPClibrary	23, 37, 49
.....XDR	180 to 182
............See also XDR (external datarepresentation)
...................primitive routines
librpcsvc library	60
lifetime of credentials,See window ofcredentials
limits
.....broadcast request size	90
.....maximum number of threads	119
linked lists
.....XDR	203 to 206, 266
listen port monitor
.....administrative command for	306
.....rpcgen tool and	30, 52 to 53
.....using	104, 105 to 106
listing
.....See also printing
.....NIS+ objects	157, 166 to 168
.....NIS+ principals	155
.....NIS+ servers	156
.....NIS+ table objects	154, 166 to 168
.....portmap mappings	300
.....remote directory listing service	30 to 35, 281 to 285
.....rpcbind addresses	248
.....rpcbind mappings	12, 243, 246
live code examples	281 to 294
.....adding two numbers program	286
.....batched code	291 to 294
.....directory listing program	281 to 285
......print message program	287 to 291
......spray packets program	286 to 287
......time server program	285
loading,See binding
local procedures
......converting to remote procedures	23 to 30
locks
......mutex, multithreaded mode and	117
......port monitor IDs and lock files	305, 315, 330
_log file
......SAC (service access controller)	330
log functions
......NIS+ transaction	153, 156
low-level data structures	82 to 85
lthread library	112

M

main server function	52
makefile templates
......rpcgen tool	22, 38
mapping	15
......See alsoportmap routine;rpcbindroutine
master servers
......NIS+	150, 153, 172
maximums
......broadcast request size	90
......number of threads	119
memory
......allocating with XDR	134 to 135
......releasing
............	45
............clnt_destroy routine	28, 68, 70, 78
............free routine	35
............NIS+	154, 155, 156
............simplified interface and	68
............svc_done routine	123
............svc_freeargs routine	135
............XDR_FREE operation	187
............xdr_free routine	35, 45

.....XDR primitive requirements for	183 to 185, 187
memory streams
.....XDR	199
mesg_proc.c routine	290 to 291
message classes	309
message interface (SAF)	306 to 309, 315, 321 to 327, 330
messageprog_1_freeresultroutine	45
modifying,See changing
msg.h header file	29
msg.x program	42, 290
msg_clnt.c routine	29
msg_svc.c program	29
msg_svc.c routine	29
MT Auto mode	117, 119 to 122
.....code examples	120 to 122
.....described	117, 119
.....rpcgen tool and	22, 37, 48
.....service transport handle and	118
MT hot
.....defined	332
MT RPC programming,See multithreadedRPC programming
MT User mode	117, 118, 123 to 130
MT-safe code
.....clients	22, 42 to 44, 45 to 47, 59, 332
.....defined	332
.....rpcgen tool and	22, 37, 42 to 48
.....servers	22, 44 to 45, 47 to 48, 59, 117, 332
multiple client versions	108 to 109
multiple server versions	106 to 108
multithreaded Auto mode,See MT Automode
multithreaded hot
.....defined	332
multithreaded RPC programming	111 to 130
.....clients
............overview	111 to 116
............safety	22, 42 to 44, 45 to 47, 59, 332
............User mode	123, 124 to 126
......library	112
......maximum number of threads	119
......overview	111
......performance enhancement	120, 127
......rpcgen tool and	22, 37, 42 to 48
......servers
............Auto mode	22, 37, 48, 117, 118, 119 to 122
............overview	111, 116 to 118
............safety	22, 44 to 45, 47 to 48, 59, 117, 332
............timing diagram	118
............unsafe routines	117
............User mode	117, 118, 123, 127 to 130
multithreaded User mode	117, 118, 123 to 130
multithreaded-safe code,See MT-safe code
mutex locks
......multithreaded mode and	117

N

Name Service Switch	152
name-to-address translation	17 to 18, 19, 137
naming
......See also identifying; NIS+ (NetworkInformation Services Plus)
......client stub programs byrpcgen	29
......netnames	100, 221
......programs by version number	106
......remote procedure calls byrpcgen	27
......server programs byrpcgen	29
......standard for	221
......template files forrpcgen	38
naming service,See NIS+ (NetworkInformation Services Plus)
netbuf addresses	18, 247
netconfig database	16, 51, 138

netdir_getbyaddr routine	18
netdir_getbyname routine	18
netnames	100, 221
NETPATH environment variable	16, 51, 70
nettype parameters	16
network addresses,See addresses
network file system,See NFS (network filesystem)
Network Information Services Plus,SeeNIS+ (Network InformationServices Plus)
network names	100, 221
network pipes	177
network selection
.....RPC	16
.....rpcgen tool	50, 51
network services
.....defined	332
Newstyle (C-style) mode
.....rpcgen tool	22, 37, 39 to 41
NFS (network file system)
.....described	4
.....Kerberos authentication and	226 to 228
NFSPROC_GETATTR procedure	227
NFSPROC_STATVFS procedure	228
nicknames
.....AUTH_DES	222 to 223, 224 to 225
.....AUTH_KERB	103 to 104, 227, 228 to 229, 230
NIS+
.....servers
............sample program	172
NIS+ (Network Information ServicesPlus)	149 to 173
.....application programming interface(API)	153 to 157
.....cache administration commands	153
.....client administration commands	153
.....compilation	158
.....database access functions	153, 155, 156
.....domains
............administration commands	153
............functions	155, 157
............overview	149 to 150
......error message display functions	153, 156
......groups
............administration commands	152
............manipulation functions	153, 155
............sample programs	163, 169 to 173
......local name functions	153, 155, 157
......miscellaneous functions	153, 157
......Name Service Switch	152
......namespace administrationcommands	152 to 153
......objects
............administration commands	152, 153
............manipulation functions	153, 154, 157
............sample programs	158 to 173
......overview	5, 149 to 153
......sample program	157 to 173
......security	151
............administration commands	152
......servers
............administration commands	153
............functions	153, 155 to 156
............overview	150
......tables
............access functions	153, 154
............administration commands	152
............overview	150 to 151
............sample programs	163 to 165
......time synchronization	156
......transaction log functions	153, 156
......unsupported macros	158
nis_add function	154, 158, 162, 164
nis_add_entry function	154, 158, 165
nis_addmember function	155, 158, 161
nis_admin functions	156
nis_cachemgr command	153
nis_checkpoint function	157
nis_clone_object function	157

nis_creategroup function	155, 158, 163
nis_db functions	156
nis_destroy_object function	157
nis_destroygroup function	155, 158, 169 to 170
nis_dir_cmp function	157
nis_domain_of function	157, 158
nis_error functions	156
nis_first_entry function	154
nis_freenames function	155
nis_freeresult function	154, 158
nis_freeservlist function	156
nis_freetags function	156
nis_getnames function	155
nis_getservlist function	156
nis_groups functions	155
nis_ismember function	155
nis_leaf_of function	157, 158, 167
nis_lerror function	156
nis_list function	154, 158, 166 to 168
nis_local_directory function	155, 158, 159
nis_local_group function	155
nis_local_host function	155
nis_local_names functions	155
nis_local_principal function	155, 158, 159
nis_lookup function	154, 158 to 160, 165, 166 to 167
nis_mkdir function	155, 158, 162
nis_modify function	154
nis_modify_entry function	154
nis_name_of function	157
nis_names functions	154
nis_next_entry function	155
nis_perror function	156, 158
nis_ping function	156
nis_print_group_entry function	155
nis_print_object function	157
nis_remove function	154, 158, 162, 168 to 169, 170
nis_remove_entry function	154, 158, 169, 170
nis_removemember function	155, 158, 170
nis_rmdir function	155
nis_server functions	155 to 156
nis_servstate function	156
nis_sperrno function	156
nis_sperror function	156
nis_stats function	156
nis_subr functions	157
nis_tables functions	154
nis_verifygroup function	155
nisaddcred command	152
nisaddent command	152
niscat command	152
nischgrp command	152
nischmod command	152
nischown command	152
nischttl command	153
nisdefaults command	153
nisgrep command	152
nisgrpadm command	152
nisinit command	153
nisln command	153
nisls command	152
nismatch command	152
nismkdir command	153
nispasswd command	152
nisrm command	153
nisrmdir command	153
nissetup command	153
nisshowcache command	153
nistbladm command	152
nisupdkeys command	152
nlsadmin command	306
no-data routine
......XDR	187
NULL arguments	63

NULL pointers	197
NULL strings	239
NULL transport type	16
number filters, XDR	65 to 66, 185 to 186
.....See alsoxdr_long routine
number of users
.....on a network	98 to 99
.....on a remote host	60
numbers
.....See also floating point; integers; portnumbers; procedurenumbers; program numbers;version numbers
.....adding two	286

O

objects (NIS+)
.....administration commands	152, 153
.....manipulation functions	153, 154, 157
.....sample programs	158, 158 to 173
ONC+ overview	3 to 5
opaque data
.....declarations
............RPC language	239
............XDR language	258 to 260
.....XDR code examples	192 to 193
open TLI file descriptors
.....passing	76, 79
optional-data unions
.....XDR language	266

P

parameters,See arguments
passing parameters,See arguments
percent sign (%), preprocessingdirective	36
_pid file	305, 315, 322, 330
ping program	230 to 231, 332
pipes
.....network	177
....._pmpipe file	307, 315, 330
....._sacpipe file	307, 315, 330
pm_maxclass field	309
pm_size field	308, 309
pmadm command	105 to 106, 306, 311, 313, 320 to 321
pmap_getmaps routine	141
pmap_getport routine	141 to 142
pmap_rmtcall routine	141
pmap_set routine	141
pmap_unset routine	141
PMAPPROC_CALLIT procedure	300
PMAPPROC_DUMP procedure	300
PMAPPROC_GETPORT procedure	299
PMAPPROC_NULL procedure	299
PMAPPROC_SET procedure	299
PMAPPROC_UNSET procedure	299
pmmsg structure	308
_pmpipe file	307, 315, 330
_pmtab file	306, 311 to 312, 315, 330
/pmtag directory	306, 311, 330
/pmtag directory	329
PMTAG environment variable	306, 315
pointers
......remote procedures	26 to 27
......RPC language	235 to 236
......XDR code examples	196 to 197
poll routine	88 to 90
pop configuration-script keyword	318
port monitors
......activity monitoring	304
......adding	302
......adding services	311
......administrative commands
............monitor-specific command	313 to 314
............pmadm	105 to 106, 306, 311, 313, 320 to 321
............sacadm	106, 302, 310, 312 to 313, 319 to 320
......administrative files
............_pmtab	306, 311 to 312, 315, 330
............_sactab	329, 310
......administrative interface	309 to 316

.....changing port monitor services	311
.....configuration scripts	316 to 321
............installing	319 to 321
............language for writing	318 to 319
............per-port monitor	315, 316, 317, 320, 330
............per-service	305, 306, 314, 315, 316, 317 to 318, 320 to 321, 330
............per-system	316, 317, 319 to 320, 329
............printing	319 to 321
............replacing	319 to 321
.....deleting services	311
.....disabling	304, 307
.....enabling	304, 307
.....files
............administrative	306, 310, 311 to 312, 315, 329, 330
............key	315
............per-port monitorconfiguration	315, 316, 317, 320, 330
............per-service configuration	305, 306, 314, 315, 316, 320 to 321, 330
............per-system configuration	316, 317, 319 to 320, 329
............private	306, 311
............process ID	305, 315, 330
.....functions	303 to 305, 315 to 316
.....home directory for	329
.....identifying services	311
.....management function	303
.....message interface	306 to 309, 315, 321 to 327, 330
....._pmpipe file	307, 315, 330
.....private files	306, 311
.....process IDs and lock files	305, 315, 330
.....removing	302
.....requirements for implementing	314 to 315
.....restricting access to system	304
.....rpcgen tool and	30, 50, 52 to 53
.....sample code	321 to 327
......service interface	314
......terminating	305, 315
......types of	310
......using	104 to 106
......utmp entry creation	305, 312, 316
......version numbers	312, 313 to 314
......writing with service access facility,SeeSAF (service access facility)
port numbers
......getting for registered services	141 to 142, 295 to 300
......portmap routine	299
......rpcbind routine	19, 245
......TCP/IP protocol	19, 245, 299
......UDP/IP protocol	19, 245, 299
porting data,See XDR (external datarepresentation)
porting TS-RPC to TI-RPC	136 to 145
......applications	136
......benefits	136
......code comparison examples	142 to 145
......differences between TI-RPC and TS-RPC	138, 142 to 145
......function compatibility lists	139 to 142
......libc library and	137
......libnsl library and	137
......name-to-address mapping and	137
......old interfaces and	137
portmap routine	295 to 300
......address management functions	141
......broadcast RPC and	297, 300
......operation of	299 to 300
......overview	295 to 296
......port number	299
......protocol specification for	296 to 298
......replacement of	18, 295
......TS-RPC and	138
ports
......defined	303
preprocessing directives
......rpcgen tool	35 to 37, 50, 51
printing
......See also listing

.....message to system console	23 to 30, 287 to 291
.....port monitor configurationscripts	319 to 321
printmsg.c program
.....remote version	24 to 30, 288 to 291
.....single process version	23 to 24, 287 to 288
procedure numbers
.....described	12, 210
.....error conditions	211
procedure-lists
.....RPC language	232
procedures
.....registering as RPC programs	13, 64
.....RPC language	232
program declarations
.....RPC language	237 to 238
program numbers	210 to 213
.....See also version numbers
.....assigning	212 to 213
.....described	12, 210
.....error conditions	211
.....mapping,Seeportmap routine;rpcbind routine
.....registering	213
.....transient (dynamically assigned)	109 to 110, 212
program-definitions
.....RPC language	232
PROGVERS program name	106
PROGVERS_ORIG program name	106
protocols
.....See also TI-RPC (transport-independent remoteprocedure call), protocol;transport protocols; XDRlanguage
.....AUTH_DES	223 to 226
.....rpcbind protocol specification	240 to 245
.....specifying in RPC language	24
push configuration-script keyword	318

Q

quadruple-precision floating point
......XDR language	257 to 258

R

raw RPC
......testing programs using low-level	85 to 87
READDIR procedure	30 to 35, 281 to 285
record streams
......XDR	199 to 201, 217 to 218
record-marking standard	217 to 218
recursive data structures	203 to 206, 266
registering
......addresses,Seeportmap routine;rpcbind routine
......authentication numbers	218
......current vs. previous release	140
......hand-coded registration routine	64
......procedures as RPC programs	13, 63, 64
......program numbers	213
......program version numbers	106
registerrpc routine	140
releasing memory,See memory, releasing
remote copy routine	131 to 134
remote directory listing service	30 to 35
remote procedure call,See RPC (remoteprocedure call)
remote procedures
......converting local procedures to	23 to 30
......identifying	12, 209, 210 to 213
remote time protocol	36, 48
removing,See deleting; destroying; freeingresources
rendezvousing
......TI-RPC and	210
rpcgen tool
......flags
............-Sc (templates)	38
replacing,See changing

replica servers
.....NIS+	150, 153
reporting,See information reporting
rls.c routine	33 to 35, 284 to 285
RPC (remote procedure call)
.....See also authentication; multithreadedRPC programming; RPClanguage (RPCL);rpcgentool
.....address lookup services	15, 18, 19
.....address registration,Seeportmaproutine;rpcbind routine
.....address reporting	20
.....address translation	17 to 18, 19, 137
.....asynchronous mode	88 to 90
.....batching	92 to 95, 213, 291 to 294
.....broadcast,See broadcast RPC
.....described	9 to 10, 208
.....errors	29, 56 to 57, 211
.....failure of	29
.....identifying remote procedures	12, 209, 210 to 213
.....indirect	244, 245, 248
.....information reporting	20, 109 to 110
.....interface routines	13 to 15, 59 to 82
............bottom level	15, 80 to 82
............caching servers	82
............expert level	15, 75 to 80
............intermediate level	14, 73 to 75
............low-level data structures	82 to 85
............overview	13 to 15, 59 to 60, 68
............simplified	13, 60 to 67, 68
............standard	13 to 15, 68 to 85
............top level	14, 28 to 29, 68 to 72
.....interface routines,See TI-RPC(transport-independentremote procedure call),interface routines
.....multiple client versions	108 to 109
.....multiple server versions	106 to 108
.....name-to-address translation	17 to 18, 19, 137
.....network selection	16
.....poll routine	88 to 90
......port monitor usage	104 to 106
......protocol,See TI-RPC (transport-independent remoteprocedure call)
............protocol
......raw, testing programs using low-level	85
......record-marking standard	217 to 218
......standards	10, 217 to 218
......transient RPC program numbers	109 to 110, 212
......transport selection	17 to 18
......transport types	16
RPC language
......reference	272 to 279
RPC language (RPCL)	230 to 240
......See alsorpcgen tool
......arrays	234 to 235
......booleans	239
......C vs.	21
......constants	233
......C-style mode and	238
......declarations	234 to 235
......definitions	231 to 232, 272
......discriminated unions	31, 236 to 237
......enumerations	31, 232 to 233
......example protocol described in	24
......example service described in	230 to 231
......fixed-length arrays	234 to 235
......keywords	31
......opaque data	239
......overview	272, 332
......pointers	235 to 236
......portmap protocol specificationin	297 to 298
......program declarations	237 to 238
......simple declarations	234
......special cases	238 to 240
......specification for	230 to 240
......strings	25, 239
......structures	31, 236
......syntax	231 to 232, 272
......type definitions	233
......unions	31, 236 to 237

.....variable-length arrays	235
.....voids	240
.....XDR language vs.	230, 232, 272
rpc.nisd command	153
RPC/XDR,See RPC language (RPCL)
RPC_AUTHERROR error	223
rpc_broadcast routine
.....current vs. previous release	141, 143
.....described	13
.....source code	144 to 145
.....using	90 to 92
rpc_call routine
.....current vs. previous release	140
.....described	13, 61
.....using	61, 62
RPC_CLNT preprocessing directive	36
rpc_control routine	117, 119, 123
rpc_createerr global variable	70
__rpc_dtbsize function	88, 89
RPC_HDR preprocessing directive	36
rpc_reg routine
.....current vs. previous release	140
.....described	13
.....using	63, 64
__rpc_select_to_poll function	88, 89
RPC_SVC preprocessing directive	36
RPC_SVC_MTMODE_GET libraryroutine	119, 123
RPC_SVC_MTMODE_SET libraryroutine	119
RPC_SVC_THRCREATES_GET libraryroutine	119
RPC_SVC_THRERRORS_GET libraryroutine	119
RPC_SVC_THRMAX_GET libraryroutine	119
RPC_SVC_THRMAX_SET libraryroutine	119
RPC_SVC_THRTOTAL_GET libraryroutine	119
RPC_TBL preprocessing directive	36
RPC_XDR preprocessing directive	36
rpcb_getaddr routine	15, 141 to 142
rpcb_getmaps routine	141
rpcb_gettime routine	141
rpcb_rmtcall routine	141
rpcb_set routine
......current vs. previous release	141
......described	15, 79
rpcb_unset routine	15, 141
rpcbind daemons
......broadcast RPC and	90
......registering addresses with	19
rpcbind routine
......See alsospecific procedures
......address management functions	141
......broadcast RPC and	240, 248
......calling	15
......described	11, 18 to 19, 138, 141, 222, 240
......listing mappings	12, 243, 246
......operation of	245 to 248
......port number	19, 245
......portmap routine replaced by	18, 295
......protocol specification for	240 to 245
......time service	141, 222, 247
......version 4	247 to 248
RPCBPROC_BCAST procedure	244, 248
RPCBPROC_CALLIT procedure	19, 243, 247, 248
RPCBPROC_DUMP procedure	243, 246
RPCBPROC_GETADDR procedure	243, 246
RPCBPROC_GETADDRLISTprocedure	245, 248
RPCBPROC_GETSTAT procedure	245, 248
RPCBPROC_GETTIME procedure	222, 244, 247
RPCBPROC_GETVERSADDRprocedure	244 to 245, 248
RPCBPROC_INDIRECT procedure	244, 245, 248
RPCBPROC_NULL procedure	243, 245
RPCBPROC_SET procedure	243, 246, 248
RPCBPROC_TADDR2UADDRprocedure	244, 247

RPCBPROC_UADDR2TADDRprocedure	244, 247
RPCBPROC_UNSET procedure	243, 246, 248
rpcgen tool	21 to 57
.....add two numbers program	286
.....advantages	22
.....arguments	26 to 27, 39 to 41, 63, 64 to 67, 238
.....authentication and	51, 54, 99 to 104
.....batched code example	291 to 294
.....broadcast call server response	50, 52
.....C and
............ANSI C compliance	23, 37, 49
............C-style mode	22, 37, 39 to 41, 238
............preprocessing directives	35 to 37, 50, 51
............SPARCompiler C++ 3.0compatibility	49
.....client handles and,See client handles
.....client programs and,See clientprograms
.....client stub routines and,See clientstub routines
.....compilation modes	22, 39 to 41
.....complex data structure passing	30 to 35
.....converting local procedures to remoteprocedures	23 to 30
.....cpp directive	37
.....debugging	50, 51, 56 to 57
.....defaults
............argument passing mode	39, 40 to 41
............C preprocessor	37
............client time-out period	53
............compilation mode	22
............library selection	49
............MT-safety	22, 42
............output	21
............server exit interval	53
.....define statements on commandline	50, 51
.....described	21 to 22
......directory listing program	30 to 35, 281 to 285
......dispatch tables	50, 55 to 56
......failure of remote procedure calls	29
......flags
............-A (MT Auto mode)	37, 48
............-a (templates)	37, 38
............-b (TS-RPC library)	37, 49
............-i (xdr_inline count)	37, 50
............listed	37
............-M (MT-safe code)	37, 42
............-N (C-style mode)	37, 39
............-Sc (templates)	37
............-Sm (templates)	37, 38
............-Ss (templates)	37, 38
......hand-coding vs.	64
......handles and,See client handles; serverhandles
......libraries
............libnsl	29, 32, 137, 138
............selecting TI-RPC or TS-RPClibrary	23, 37, 49
......MT (multithread) Auto mode	22, 37, 48, 119 to 122
......MT (multithread)-safe code	22, 37, 42 to 48
......naming remote procedure calls	27
......network types/transportselection	50, 51
......Newstyle (C-style) mode	22, 37, 39 to 41
......optional output	21
......pointers	26 to 27
......port monitor support	30, 50, 52 to 53
......preprocessing directives	35 to 37, 50, 51
......print message program	23 to 30, 287 to 291
......programming techniques	50 to 57
......server handles and,See server handles
......server programs and,See serverprograms
......server stub routines and,See serverstub routines
......socket functions and	49
......spray packets program	286 to 287

.....stub routines and,See client stubroutines; server stubroutines
.....SunOS 5.x features	22 to 23
.....templates	22, 37, 38, 39 to 41
.....time server program	36, 48, 285
.....time-out changes	51, 53
.....TI-RPC vs. TS-RPC	138
.....TI-RPC vs. TS-RPC libraryselection	23, 37, 49
.....tutorial	23 to 37
.....variable declarations and	234
.....XDR routine generation	30 to 35, 36, 175
.....xdr_inline count	37, 50
rpcinfo routine	19, 20
RPCPROGVERSMISMATCH error	108
/rpcsvc directory	213
rprintmsg routine	30
rq_clntcred field	97
rq_cred field	96 to 97
rstat program
.....multithreaded	111 to 116
run configuration-script keyword	319
runwait configuration-scriptkeyword	318 to 319
rusers routine	60 to 63

S

SAC (service access controller)
.....described	302 to 305
.....key files	310, 315, 329
.....log file	330
.....message interface	306 to 309, 315, 321 to 327, 330
.....sac.h header file	325 to 327
.....sacadm command	106, 302, 310, 312 to 313, 319 to 320
....._sacpipe file	307, 315, 330
....._sactab file	310, 329
.....starting	315, 317
sac.h header file	325 to 327
sacadm command	106, 302, 310, 312 to 313, 319 to 320
_sacpipe file	307, 315, 330
_sactab file	310, 329
SAF (service access facility)	301 to 330
......administrative interface	309 to 316, 319 to 321
............key files	315
............monitor-specific command	313 to 314
............pmadm command	105 to 106, 306, 311, 313, 320 to 321
............_pmtab file	306, 311 to 312, 315, 330
............port monitor implementationrequirements	314 to 315
............port monitorresponsibilities	315 to 316
............sacadm command	106, 302, 310, 312 to 313, 319 to 320
............_sactab file	310, 329
............service interface	314
......configuration scripts	316 to 321
............installing	319 to 321
............language for writing	318 to 319
............per-port monitor	315, 316, 317, 320, 330
............per-service	305, 306, 314, 315, 316, 317 to 318, 320 to 321, 330
............per-system	316, 317, 319 to 320, 329
............printing	319 to 321
............replacing	319 to 321
......directory structure	329 to 330
......files used by	306, 310, 311 to 312, 315
......logic diagram	327, 328
......message interface	306 to 309, 315, 321 to 327, 330
......overview	301 to 305
......port monitor functions and	303 to 305, 315 to 316
......SAC (service access controller)and	302 to 305, 306 to 309

.....sample code	321 to 327
.....terminating port monitors	305, 315
sc_size field	307, 309
searching NIS+ tables	154
security
.....See also access control; authentication
.....NIS+	151
semantics
.....TI-RPC call	12, 209
serializing	30 to 35, 64 to 67, 134 to 135, 177 to 179, 181 to 182, 332
.....See also XDR (external datarepresentation)
server handles
.....creating
............bottom level interface	15, 81 to 82
............current vs. previous release	139 to 140
............expert level interface	15, 79 to 80
............intermediate level interface	14, 74 to 75
............top level interface	14, 71 to 72
.....destroying, current vs. previousrelease	139
.....low-level data structures for	83 to 85
server programs
.....remote copy	133 to 134
.....rpcgen tool and
............broadcast call response	50, 52
............client authentication	51, 54, 96 to 97
............complex data structurepassing	32 to 33
............C-style mode	41
............debugging	56 to 57
............directory listing service	32 to 33, 282 to 283
............MT Auto mode	48
............MT-safety	22, 47 to 48
............network type/transportselection	50, 51
............overview	23, 29
.....simplified interface	63
.....transient RPC program	110
server stub routines
......rpcgen	21
......rpcgen tool and	21
......rpcgen tool and	23, 29
............ANSI C-compliant	49
............MT Auto mode	48
............MT-safe	22, 44 to 45
............preprocessing directive	36
server templates
......rpcgen tool	22, 37, 38, 41
server transport handle	83 to 85
servers
......See also registering
......authentication and	96 to 97, 98 to 99, 100 to 101
......batched	94 to 95, 292 to 293
......caching	82
......crashes	209, 223
......defined	332, 333
......dispatch tables	50, 55 to 56
......exit interval,rpcgen tool and	52 to 53
......multiple versions	106 to 108
......multithreaded
............Auto mode	22, 37, 48, 117, 118, 119 to 122
............overview	111, 116 to 118
............safety	22, 44 to 45, 47 to 48, 59, 117, 332
............unsafe routines	117
............User mode	117, 118, 123, 127 to 130
......NIS+	150, 153, 155 to 156
......poll routine and	88 to 90
......port monitors and	104 to 106
......transaction IDs and	209
service access controller,See SAC (serviceaccess controller)
service access facility,See SAF (serviceaccess facility)
service transport handle (SVCXPRT)	104, 118
service-dispatch routine
......authentication and	96 to 97

setnetconfig routine	78
signed integers
.....XDR language	253 to 254
simple declarations
.....RPC language	234
simplified interface routines (RPC)	13, 60 to 67
.....client	61 to 62
.....hand-coded registration routine	64
.....MT safety of	59
.....overview	13, 60
.....routines not usable with	68
.....server	63
.....XDR conversion	64 to 67
single-threaded mode
.....as default	117
.....poll routine and	88 to 90
socket functions,See TS-RPC (transport-specific remote procedure call)
SPARCompiler C++ 3.0
.....rpcgen tool and	49
spray.x (spray packets) program	286 to 287
standard interface routines (RPC)	13 to 15, 68 to 85
.....bottom level routines	15, 80 to 82
.....expert level routines	15, 75 to 80
.....intermediate level routines	14, 73 to 75
.....low-level data structures	82 to 85
.....MT safety of	59
.....server caching	82
.....top level routines	14, 28 to 29, 68 to 72
standards
.....ANSI C standard,	23
.....ANSI C standard,rpcgen tooland	37, 49
.....naming standard	221
.....record-marking standard	217 to 218
.....RPC	10, 217 to 218
.....XDR canonical standard	179 to 180
statistics,See information reporting
status reporting,See information reporting
stream transports
......See also connection-orientedtransports
......defined	333
STREAMS modules
......port monitor configuration and	318, 320
streams,See XDR (external datarepresentation), streams
string declarations
......RPC language	25, 239
......XDR language	260 to 261
string representation
......XDR routines	67, 187 to 188
structure declarations
......See also data structures
......RPC language	31, 236
......XDR language	263, 270 to 271
stub routines,See client stub routines;server stub routines
Sun RPC,See TI-RPC (transport-independent remote procedurecall)
SunOS 5.x
......rpcgen tool features	22 to 23
_svc suffix	49
_svc.c suffix	29
svc_create routine
......current vs. previous release	140
......described	14, 72
svc_destroy routine	68, 139
svc_dg_create routine
......current vs. previous release	140
......described	15, 84
......using	82
svc_dg_enablecache routine	82
svc_done routine	117, 123
svc_fd_create routine	104 to 105, 140
svc_freeargs routine	135
svc_getargs routine
......described	135
......MT performance and	120, 127
svc_getcaller routine	140
svc_getreqpoll routine	88, 117

svc_getreqset routine	88, 117
svc_getrpccaller routine	140
svc_pollset routine	88
svc_raw_create routine	85 to 87, 139, 140
svc_reg routine
.....current vs. previous release	140
.....described	15
.....port monitors and	104
svc_register routine	140
svc_run routine
.....bypassing	88
.....described	63, 72
.....multithreaded RPC servers and	117
.....poll routine and	88, 89 to 90
svc_sendreply routine	72
svc_tli_create routine
.....current vs. previous release	140
.....described	15, 79
.....using	79, 80, 104
svc_tp_create routine	14, 139, 140
svc_udp_bufcreate routine	139
svc_unreg routine	15, 140
svc_unregister routine	140
svc_vc_create routine
.....current vs. previous release	140
.....described	15, 84
.....using	82
svcerr_systemerr routine	99
svcfd_create routine	139
svctag file	311 to 312, 315, 316, 330
svcudp_create routine	79 to 80, 139
SVCXPRT service transport handle	104, 118
svrerr_weakauth routine	99
synchronization,See time synchronization
syntax
.....RPC language	231 to 232, 272
.....XDR language	269 to 270
	320
_sysconfig file	316, 317, 319 to 320, 329

T

tables (NIS+)
......access functions	153, 154
......administration commands	152
......overview	150 to 151
......sample programs	163 to 165
taddr2uaddr routine	18
/tag directory,See/pmtag directory
TCP (transport control protocol)
......See also connection-orientedtransports
......nettype parameter for	16
......porting TCP applications from TS-RPC to TI-RPC	136
......portmap port number for	299
......portmap sequence for	296 to 297
......RPC protocol and	209
......rpcbind port number for	19, 245
......server crashes and	209
tcp transport type	16
TCP/IP protocol,See TCP (transportcontrol protocol)
TCP/IP streams
......XDR	199 to 201, 217 to 218
templates
......rpcgen tool	22, 37, 38, 39 to 41
terminating port monitors	305, 315
testing
......NIS+ groups	155
......programs using low-level rawRPC	85 to 87
thr_create routine	123
thread library
......lthread	112
thread.h file	123
threads,See MT Auto mode; MT Usermode; MT-safe code;multithreaded RPCprogramming
time
......obtaining current	141, 222, 247
......ping program	230 to 231
time server program	36, 48, 285

time service
.....intermediate level client for	73 to 74
.....intermediate level server for	74 to 75
.....rpcbind routine	141, 222, 247
.....top level client for	69 to 70
.....top level server for	71 to 72
time synchronization
.....AUTH_DES authentication	100, 222 to 223
.....AUTH_KERB authentication	102, 229, 230
.....NIS+	156
time.x program	36, 48, 285
time_prog routine	72
timed client creation
.....intermediate level interface	14, 74
.....top level interface	14, 70
time-out periods
.....rpcgen tool and	51, 53
timestamps,See time synchronization
TI-RPC (transport-independent remoteprocedure call)
.....See also RPC (remote procedure call);rpcgen tool
.....address lookup services	15, 18, 19
.....address registration,Seerpcbindroutine
.....address reporting	20
.....address translation	17 to 18, 19, 137
.....call semantics	12
.....data representation	12
.....described	4, 9 to 10
.....identifying remote procedures	12, 209, 210 to 213
.....information reporting	20, 109 to 110
.....interface routines	13 to 15, 59 to 82
............bottom level	15, 80 to 82
............caching servers	82
............expert level	15, 75 to 80
............intermediate level	14, 73 to 75
............low-level data structures	82 to 85
............overview	13 to 15, 59 to 60, 68
............simplified	13, 60 to 67, 68
............standard	13 to 15, 68 to 85
............top level	14, 28 to 29, 68 to 72
......library selection,rpcgen tooland	23, 37, 49
......name-to-address translation	17 to 18, 19, 137
......network selection	16
......parameter passing,See arguments
......protocol	207 to 218
............See also RPC language (RPCL)
............authentication and	211 to 212
............binding and rendezvousindependence and	11, 210
............identifying procedures	12, 209, 210 to 213
............in XDR language	214 to 217
............overview	207 to 209
............record-marking standard	217 to 218
............transport protocols andsemantics and	11, 12, 209
............version number	211
......raw, testing programs using low-level	85 to 87
......transient RPC program numbers	109 to 110, 212
......transport selection	17 to 18
......transport types	16
......TS-RPC and,See porting TS-RPC toTI-RPC
TLI (transport-level interface),See expertlevel interface routines
TLI file descriptors
......passing open	76, 79
top level interface routines (RPC)	14, 28 to 29, 68 to 72
......client	28 to 29, 68 to 70
......overview	14, 68
......server	71 to 72
transaction IDs	12, 209
transaction log functions (NIS+)	153, 156
transient program numbers	109 to 110, 212
translating,See converting

transport
.....defined	333
transport addresses (netbufaddresses)	18, 247
transport handles
.....defined	333
.....server	83 to 85
.....SVCXPRT service	104, 118
.....XDR routines requiring	68
transport protocols
.....See also TCP (transport controlprotocol); UDP (userdatagram protocol)
.....RPC protocol and	209
transport selection
.....RPC	17 to 18
.....rpcgen tool	50, 51
transport types
.....See also connection-orientedtransports; connectionlesstransports
.....described	16, 17
.....interfaces and	68
.....rpcgen tool and	50, 51
transport-independent remote procedurecall,See TI-RPC (transport-independent remote procedurecall)
transport-level interface (TLI) routines,Seeexpert level interface routines
transport-level interface file descriptors
.....passing open	76, 79
transport-specific remote procedure call,See TS-RPC (transport-specificremote procedure call)
trees	266
TS-RPC (transport-specific remoteprocedure call)
.....library selection,rpcgen tooland	37, 49
.....porting to TI-RPC,See porting TS-RPC to TI-RPC
ttyadm command	306
ttymon port monitor	306
tutorials
......	23, 37
type definitions
......RPC language	233
......XDR language	265 to 266, 270

U

uaddr2taddr routine	18
UDP (user datagram protocol)
......See also datagram transports
......broadcast RPC and	90
......client creation routines for	76 to 78, 81
......nettype parameter for	16
......porting UDP applications from TS-RPC to TI-RPC	136
......portmap port number for	299
......RCP protocol and	209
......rpcbind port number for	19, 245
......server creation routines for	79 to 80, 81 to 82
udp transport type	16
UDP/IP protocol,See UDP (user datagramprotocol)
ulimit command	319
umask command	319
unions
......declarations
............RPC language	31, 236 to 237
............XDR language	263 to 264, 266, 270
......XDR code samples	194 to 196
universal addresses	17 to 18, 246, 247, 296, 333
unregistering
......See also registering
......current vs. previous release	140
......portmap routine	299
......rpcbind routine	18, 243, 246
......rpcinfo routine	20
unsigned hyper integers
......XDR language	255 to 256
unsigned integers

.....XDR language	254
user datagram protocol,See UDP (userdatagram protocol)
User MT mode	117, 118, 123 to 130
user's bind address
.....passing	79
users
.....number of
............on a network	98 to 99
............on a remote host	60
/usr/include/rpcsvc directory	213
/usr/share/lib directory	35
utmp entries
.....creating	305, 312, 316

V

/var/saf/_log file	330
/var/saf/pmtag directory	306, 311, 330
variable declarations	234
variable-length array declarations
.....See also arrays
.....RPC language	235
.....XDR language	262
variable-length opaque data
.....See also opaque data
.....XDR language	259 to 260
verifiers
.....AUTH_DES	221 to 222, 224 to 225
.....AUTH_KERB	103, 104, 228, 229 to 230
.....AUTH_SYS	219 to 220
.....described	211 to 212
version numbers
.....See also program numbers; versions
.....assigning	106
.....changing	106
.....described	12, 106, 210
.....error conditions	211
.....mapping,Seeportmap routine;rpcbind routine
.....message protocol	211
.....multiple client versions	108 to 109
.....multiple server versions	106 to 108
.....port monitors	312, 313 to 314
......registration of	106
version-lists
......RPC language	232
versions
......See also version numbers
......library functions, compatibility ofcurrent vs. previousrelease	139 to 142
......RPC language	232
visible transport type	16
void arguments	238
void declarations
......RPC language	240
......XDR language	264

W

window of credentials
......AUTH_DES authentication	100, 223 to 224
......AUTH_KERB authentication	102, 229
......defined	222
......window verifiers	222

X

x_base field	202
x_destroy macro	202
x_getbytes routine	202
x_getlong routine	202 to 203
x_getpostn macro	202
x_handy field	202
x_inline routine	202
x_op	198
x_op field	202
x_private field	202
x_public field	202
x_putbytes routine	202
x_putlong routine	202 to 203
x_setpostn macro	202
.x suffix	32
XDR (external data representation)	175 to 206

.....See also XDR language
.....block size	252
.....canonical standard	179 to 180
.....converting from (deserializing)	64, 67, 72, 134, 135, 181 to 182, 331
.....converting to (serializing)	30 to 35, 64 to 67, 134 to 135, 177 to 179, 181 to 182, 332
.....cost of conversion	179 to 180
.....described	4, 175 to 179, 251
.....direction determination foroperations	198
.....direction independence ofroutines	181
.....file data structure in	270 to 271
.....graphic box notation	252
.....library	180 to 182
............See also XDR (external datarepresentation), primitiveroutines
.....linked lists	203 to 206, 266
.....memory allocation with	134 to 135
.....optimizing routines	198
.....primitive routines	65 to 67, 181, 182 to 201
............arrays	189 to 192, 193 to 194
............byte arrays	189
............constructed (compound) datatype filters	66 to 67, 187
............discriminated unions	194 to 196
............enumeration filters	186 to 187
............fixed-length arrays	193 to 194
............floating point filters	65, 186
............memory requirements	183 to 185, 187
............no-data routine	187
............nonfilter	198
............number filters	65 to 66, 185 to 186
............opaque data	192 to 193
............overview	182
............pointers	196 to 197
............strings	67, 187 to 188
............unions	194 to 196
.....protocol,See XDR language
......remote copy (two-way XDR)routine	131 to 134
......rpcgen tool and	30 to 35, 36, 175
......streams
............accessing	198
............creation by RPC system	180
............implementing new instancesof	201 to 203
............interface to	201 to 203
............memory	199
............nonfilter primitives for	198
............record (TCP/IP)	199 to 201, 217 to 218
............standard I/O	199
......transport handles and	68
XDR language	253 to 271
......arrays	261 to 262, 270
......AUTH_DES authentication protocolin	223 to 226
......booleans	255
......comments	267
......constants	265, 267, 270
......counted byte strings	260 to 261
......declarations	253 to 266
......discriminated unions	263 to 264, 266, 270
......enumerations	254 to 255
......file data structure described in	270 to 271
......fixed-length arrays	261 to 262
......fixed-length opaque data	258 to 259
......floating point	256 to 258
......hyper integers	255 to 256
......identifiers	267
......integers	177 to 178, 253 to 254, 255 to 256
......keywords	269
......opaque data	258 to 260
......optional-data unions	266
......overview	251 to 252, 333
......quadruple-precision floatingpoint	257 to 258
......RPC language vs.	230, 232, 272
......RPC message protocol in	214 to 217
......signed integers	253 to 254

.....specification for	267 to 271
.....strings	260 to 261
.....structures	263, 270 to 271
.....syntax	269 to 270
.....type definitions	265 to 266, 270
.....unions	263 to 264, 266, 270
.....unsigned hyper integers	255 to 256
.....unsigned integers	254
.....variable-length arrays	262
.....variable-length opaque data	259 to 260
.....voids	264
xdr_ prefix	32
xdr_array routine	66, 189 to 192, 196
xdr_bool routine	65
xdr_bytes routine	66, 67, 189
xdr_char routine	65, 185
xdr_chararr routines	134 to 135
xdr_cnd routine	192
XDR_DECODE operation	187
xdr_destroy routine	198
xdr_double routine	65, 186
xdr_element routine	190
XDR_ENCODE operation	187
xdr_enum routine	65
xdr_float routine	65, 186
XDR_FREE operation	187
xdr_free routine	35, 45
xdr_getpos routine	198
xdr_gnumbers routine	181 to 182, 203 to 206
xdr_history routine	192
xdr_inline count	37, 50
xdr_int routine	65, 185
xdr_long routine	65, 177 to 178, 181, 185
xdr_netobj routine	65, 193
xdr_opaque routine	66, 192
xdr_party routine	191
xdr_pgn routine	197
xdr_pointer routine	66, 197, 204 to 205, 206
xdr_quadruple routine	65
xdr_rcp routine	131 to 134, 143
xdr_reference routine	66, 67, 196 to 197, 206
xdr_setpos routine	198
xdr_short routine	65, 186
xdr_simple routine	65, 67
xdr_sizeof routine	183 to 185
xdr_string routine	65, 66, 67, 188, 191, 192
xdr_type(object) notation	103
xdr_u_char routine	65, 185
xdr_u_int routine	65, 185
xdr_u_long routine	65, 186
xdr_u_short routine	65, 186
xdr_union routine	66, 194 to 196
xdr_varintarr routine	66
xdr_vector routine	66 to 67, 193 to 194
xdr_void routine	65, 187
xdr_wrapstring routine	65, 191, 192
xdrmem_create routine	199
xdrrec_create routine	200
xdrrec_endofrecord routine	200 to 201
xdrrec_eof routine	201
xdrrec_skiprecord routine	201
xdrstdio_create routine	180, 199
xp_fd field	84
xp_ltaddr field	84
xp_netid field	84
xp_rtaddr field	84
xp_tp field	84
xprt_register routine	140
xprt_unregister routine	140