RELEASE.TXT



DIGITAL UNIX ATM Sockets Application Programmers Interface (API).

=================================================================

    

Copyright (c) Digital Equipment Corporation, 1997.

All Rights Reserved.  Unpublished rights reserved

under the copyright laws of the United States.



RESTRICTED RIGHTS LEGEND   Use, duplication, or 

disclosure by the U.S. Government is subject to

restrictions as set forth in Subparagraph (c)(1)(ii)

of DFARS 252.227-7013, or in FAR 52.227-19, as applicable.



Contents:

1. VERSION INFORMATION

2. KNOWN BUGS

3. LIMITATIONS

4. BUG FIXES AND NEW FEATURES

5. EXAMPLE PROGRAMS



***********************

* VERSION INFORMATION *

***********************



To determine the version of an existing ATM sockets

API, use the command:



     setld -i | grep ATMSOCK



The resulting output data gives the version information.



**************

* KNOWN BUGS *

**************



There are no known bugs.



***************

* LIMITATIONS *

***************



The API does not set the ATM_PARAMS structure to default values. 

User applications MUST set all structure member fields correctly

before executing the SIO_ASS0CIATE_PVC ioctl call with the

ATM_PARAMS structure.  Failure to do so may result in unexpected

API and/or device driver behavior.



The API could potentially fail to open a socket if the user 

overrides the OS default for sb_max.  Since the API allocates

the maximum socket buffer size on receive, any sysconfig

reconfiguration that lowers the sb_max value from the kernel

default could cause the API to fail.  The same condition exists

if the sysconfigtab file overrides the kernel sb_max value.  The

API's current value is 65536.  If the API posts the console

message "[ socket call failed, error: xx ]", try the command:



     sysconfig -r sb_max=131072 <CR>



and reissue the API call.  Also check the /etc/sysconfigtab file.

Search for the sb_max option and, if present, alter its value to 131072.

This command makes the change persistent across boots.





******************************

* BUG FIXES AND NEW FEATURES *

******************************



For Version 1.10



The receive reserve buffer size value was hard-coded in version 1.00 to

the kernel default. The kernel default, sb_max, is defined in the

socketvar.h file, but can be overridden by the user via the sysconfigtab

file or sysconfig -r command.  The new version sets the receive buffer size 

to one-half of the kernel sb_max value.



For Version 1.00



This is the initial full release.  All previous versions were field

test only.



********************

* EXAMPLE PROGRAMS *

********************



Please see the progref.doc or progref.ps, section 6, for a description 

of all example programs included with this kit.



=============================================================

TRADEMARKS



DEC, DIGITAL, and DECpc are trademarks of Digital Equipment 

Corporation. 



All other trademarks and registered trademarks are the 

property of their respective holders.