Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rapi_session(3) [osf1 man page]

rapi_session(3) 					     Library Functions Manual						   rapi_session(3)

NAME
rapi_session - Create an Resource ReSerVation Protocol (RSVP) API session LIBRARY
RAPI Library (librsvp.so, librsvp.a) SYNOPSIS
#include <rapi.h> rapi_sid_t rapi_session( rapi_addr_t *Dest, int Protid, unsigned int flags, rapi_event_return_t *Event_rtn, void *Event_arg, int *errnop); PARAMETERS
Points to a rapi_addr_t structure that contains the destination IP address (IPv4 or IPv6) and port number to which data is sent. The Dest and Protid parameters together define an RSVP session. If the Protid specifies the UDP or TCP transport, the port corresponds to the appropriate transport port number. See RSVP(7) for the format of the rapi_addr_t structure. Specifies the IP protocol identifier for the session. If you do not set this parameter, the API defaults to the UDP protocol (value 17). Specifies one of the following flags: If this flag is set, this indicates that IntServ formats are used on upcalls; otherwise, Simplified formats are used. See RSVP(7) for a descrip- tion of RAPI objects and formats. Points to an upcall routine that is invoked to notify the application of RSVP errors and state change events. Pending events cause the invocation of the upcall function. If no such upcall routine exists, set the parameter to NULL. See rapi_event_rtn_t(3) for more information. Points to an argument to be passed to the upcall routine when it is invoked. This is an optional parameter. Points to an integer into which a RSVP API (RAPI) error code is returned. DESCRIPTION
The rapi_session() routine creates an RSVP API session. If the call to rapi_session() succeeds, the application might receive upcalls of type RAPI_PATH_EVENT for the API session. NOTES
An application can have multiple API sessions registered for the same RSVP session or different RSVP sessions at the same time. Each API session can have only one sender associated with it. Therefore, in order to announce multiple senders for a given RSVP session, an appli- cation must announce each sender in a separate API session. If two API sessions for the same RSVP session are receiving data, they are assumed to have joined the same multicast group and will receive the same data packets. At present, if two or more such sessions issue calls to the rapi_reserve() routine, their reservation parameters must agree or unpredictable results occur; reservation parameter conflicts are not checked. RETURN VALUES
Upon successful completion, the rapi_session() routine returns a non-zero session handle for use in subsequent calls related to this RSVP API session. Upon failure, it returns a session handle with a value of zero (RAPI_NULL_SID) and sets an integer variable pointed to by errnop to an RAPI error code. RELATED INFORMATION
Functions: rapi_dispatch(3), rapi_event_rtn_t(3), rapi_getfd(3), rapi_release(3), rapi_reserve(3), rapi_sender(3), rapi_strerror(3), rapi_version(3). Network: RSVP(7). delim off rapi_session(3)

Check Out this Related Man Page

rsvpd(8)						      System Manager's Manual							  rsvpd(8)

NAME
rsvpd - Resource ReSerVation Protocol (RSVP) daemon SYNOPSIS
/usr/sbin/rsvpd [-h] [-d level] [-p] [-l logfile] [-i [version]] OPTIONS
Prints the rsvpd help and exits. Enables debug mode. The debug level is either all (the default) or a bitmask that specifies a combina- tion of the following values: 0x01 (SYSTEM) 0x02 (TMR) 0x04 (API) 0x08 (MSGS) 0x10 (TCNTL) 0x20 (SESS) 0x40 (ROUTE) Forces rsvpd to stay attached to the terminal and print error and debug information to stderr instead of the log file. Specifies an alternative log file. By default, the log file is /var/rsvp/rsvpd_dbg.log. Specifies a list of Internet Protocol (IP) version numbers. Possible values are 4, 6, or 46. DESCRIPTION
The rsvpd daemon is the RSVP daemon that starts automatically at boot time. Upon startup, rsvpd performs the following actions: Writes its PID to the /var/run/rsvpd.pid file. Detects all existing interfaces on the system. Detaches from the terminal unless the -p option is specified. Creates the /var/rsvp directory, if it does not exist. The rsvpd daemon logs startup, stop, and error messages through the syslog function to the /usr/var/adm/syslog.dated/date/daemon.log log file. If you specify the -d option, rsvpd logs error messages and debugging output to the /var/rsvp/rsvpd_dbg.log log file or to a log file specified with the -l logfile option. If you want rsvpd to start automatically at system boot time, place an entry for it in the /etc/inet.local file. For example: echo "Starting local Internet services." # do not let RSVP reserve more than 20 Mbit/s on the FDDI interface /usr/sbin/iftcntl fta0 config max_total_r 20000000 # start the RSVP daemon /usr/sbin/rsvpd If you make any changes to the network interface configuration, restart the rsvpd daemon. If you want to use mrouted and rsvpd on a system, start mrouted before rsvpd. If mrouted is running on your system, rsvpd acts as an RSVP multicast router. If IPv4/IPv6 forwarding is enabled on the system, rsvpd acts as an RSVP IPv4/IPv6 unicast router. Restricting RSVP Usage To restrict RSVP usage to a limited number of users on the system, set the permissions for the /var/rsvp directory as follows: # chmod 750 /var/rsvp # chgrp staff /var/rsvp Those users who cannot access the /var/rsvp directory will be unable to request RSVP reservations, use any RSVP API (RAPI) function, or use the rsvpstat command. RESTRICTIONS
You must be superuser to invoke the rsvpd daemon. FILES
The rsvpd log file when debugging is enabled. This directory contains the RSVP API library UNIX domain socket. The file that contains the process ID of the rsvpd daemon that is currently running. SEE ALSO
Commands: iftcntl(8), rsvpstat(8) Networking: RSVP(7) rsvpd(8)
Man Page