.\" 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 "IUCV_REGISTER_PROGRAM" "" "06 October 2005" "" ""

.SH NAME
iucv_register_program \- 
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
iucv_handle_t iucv_register_program  (__u8 * \fIpgmname\fB, __u8 * \fIuserid\fB, __u8 * \fIpgmmask\fB, iucv_interrupt_ops_t * \fIops\fB, void * \fIpgm_data\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIpgmname\fB\fR
user identification
.TP
\fB\fIuserid\fB\fR
machine identification
.TP
\fB\fIpgmmask\fB\fR
Indicates which bits in the pgmname and userid combined will be
used to determine who is given control.
.TP
\fB\fIops\fB\fR
Address of interrupt handler table.
.TP
\fB\fIpgm_data\fB\fR
Application data to be passed to interrupt handlers.
.SH "DESCRIPTION"
.PP
Registers an application with IUCV.
.SH "RETURNS"
.PP
The address of handler, or NULL on failure.
.SH "NOTE ON PGMMASK"
.PP
If pgmname, userid and pgmmask are provided, pgmmask is entered into the
handler as is.
If pgmmask is NULL, the internal mask is set to all 0xff's
When userid is NULL, the first 8 bytes of the internal mask are forced
to 0x00.
If pgmmask and userid are NULL, the first 8 bytes of the internal mask
are forced to 0x00 and the last 16 bytes to 0xff.