CAP(3)

NAME
libcap - base CAP networking library
libafpc - afp client protocol library
libafp - afp support routines

DESCRIPTION
libcap is the library of routines that implement a large subset of the AppleTalk protocols. There are two different LAP delivery mechanisms for CAP: IPTalk and Ethertalk (possibly using UAB). For a discussion of the differences, and details on configuring the CAP system, see CAP(8).

The architecture of the CAP AppleTalk protocol implementation is fairly simple. At the lowest layer, the various LAP mechanisms provide DDP support. On top of the DDP layer, ATP and NBP provide the basic transport and name binding functionality. ASP, PAP, and the parts of ZIP that are implemented are layered on top of ATP.

The protocols are not run automatically. Programs are responsible for giving up the cpu at regular intervals by a call to a "sleep" routine (abSleep) to allow the protocols to run. The various protocols will schedule two kinds of events that can be run. The first is a "packet ready" event that indicates input is ready on a particular socket. The second is a "timeout" event. Note: a "packet ready" event takes precendent over a "timeout" event. These events are handled by calling handler routines that run fairly quickly and without blocking. See doc/sched.notes in the source directory for futher information.

The afp client protocols are in libafpc. The library libafp provides a set of support routines for AFP client and server programs.

DEBUG FLAGS
The following standard CAP debugging flags are provided by the abmisc dbugarg routine.
	d - DDP
	a - ATP
	n - NBP
	p - PAP
	s - ASP
	k - Scheduler
	v - Version
The following flags are also accepted, but are not used.
	i - Initialization code
	l - LAP
The version flag prints details about the CAP release and current patch level, together with a string describing the low level delivery method.

SEE ALSO
CAP(8), AUFS(8), atis(8), atprint(1), atlook(1)

See the following files in the source code directory for CAP:
doc/abmisc.doc	miscellaneous routines
doc/asp.notes	asp notes
doc/atp.notes	atp notes
doc/cap.notes	general notes
doc/nbp.ext	nbp extensions for unix
doc/pap.notes	pap notes
doc/sched.notes	protocol scheduler notes