.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "LLC_UI_BIND" "" "06 October 2005" "" ""

.SH NAME
llc_ui_bind \- bind a socket to a specific address.
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int llc_ui_bind  (struct socket * \fIsock\fB, struct sockaddr * \fIuaddr\fB, int \fIaddrlen\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIsock\fB\fR
Socket to bind an address to.
.TP
\fB\fIuaddr\fB\fR
Address the user wants the socket bound to.
.TP
\fB\fIaddrlen\fB\fR
Length of the uaddr structure.
.SH "DESCRIPTION"
.PP
Bind a socket to a specific address. For llc a user is able to bind to
a specific sap only or mac + sap. If the user only specifies a sap and
a null dmac (all zeros) the user is attempting to bind to an entire
sap. This will stop anyone else on the local system from using that
sap. If someone else has a mac + sap open the bind to null + sap will
fail.
If the user desires to bind to a specific mac + sap, it is possible to
have multiple sap connections via multiple macs.
Bind and autobind for that matter must enforce the correct sap usage
otherwise all hell will break loose.
.SH "RETURNS"
.PP
0 upon success, negative otherwise.