#pragma	module	tcpip$tcp_server_qio_auxs		\
		"V5.4-00"

/*
 * © Copyright 1976, 2003 Hewlett-Packard Development Company, L.P.
 *
 * Confidential computer software.  Valid license  from  HP  and/or its
 * subsidiaries required for possession, use, or copying.
 *
 * Consistent with FAR 12.211 and 12.212, Commercial Computer Software,
 * Computer Software Documentation,  and  Technical Data for Commercial
 * Items  are  licensed to the U.S. Government under vendor's  standard
 * commercial license.
 *
 * Neither HP nor any of its subsidiaries shall be liable for technical
 * or editorial errors or omissions contained herein.   The information
 * in  this document is provided  "as is"  without warranty of any kind
 * and is subject  to  change  without  notice.   The warranties for HP
 * products are set forth in the express  limited  warranty  statements
 * accompanying such products.   Nothing herein should be construed  as
 * constituting an additional warranty.
 *
 * ++
 * FACILITY:
 *
 *    EXAMPLES
 *      
 * ABSTRACT:
 *
 *    This is an example of a TCP/IP IPv4 server using  OpenVMS
 *    QIO system services to handle network I/O operations.  In
 *    addition, it  shows  how  to  accept connections from the
 *    auxiliary server.
 *
 *    Refer to 'Build, Configuration, and Run Instructions' for
 *    details on how to build, configure, and run this program.
 *
 * ENVIRONMENT:
 *
 *    OpenVMS Alpha/VAX V7.1
 *    TCP/IP Services V5.0 or higher
 *
 * AUTHOR:
 *
 *    TCPIP Development Group,  CREATION DATE: 23-May-1989
 *
 * --
 */

	/* Build, Configuration, and Run Instructions */

/*
 *  BUILD INSTRUCTIONS:
 *
 *    To build this example program use commands of the form,
 *
 *    using the "C" compiler:
 *
 *	$ cc/prefix=all TCPIP$TCP_SERVER_QIO_AUXS.C
 *      $ link TCPIP$TCP_SERVER_QIO_AUXS
 *
 *
 * CONFIGURATION INSTRUCTIONS:
 *
 *    To configure this example program:
 *
 *    1) Create a service run command procedure, named HELLO_RUN.COM, that
 *       contains the following lines:
 *
 *	 $ define sys$output ddcu:[directory]hello_service.log
 *	 $ define sys$error  ddcu:[directory]hello_service.log
 *	 $ run ddcu:[directory]tcpip$tcp_server_qio_auxs.exe
 *
 *	 where: ddcu:[directory] is the device and directory of where the
 *		hello service run command procedure file resides
 *
 *    2) Create a service database entry for the hello service as shown below:
 *
 *	 $ tcpip set service hello -
 *	 _$ /port=12345 -
 *	 _$ /protocol=tcp -
 *	 _$ /user=vms_user_account -
 *	 _$ /process_name=hello_world -
 *	 _$ /file=ddcu:[directory]hello_run.com
 *	
 *    3) Enable the hello service to run as shown below:
 *
 *	 $ tcpip enable service hello
 *
 *
 * RUN INSTRUCTIONS:
 *
 *    To run this example program:
 *
 *    1) Start the client program, entering the server host as shown below:
 *
 *	 $ run tcpip$tcp_client_sock
 *	 Enter remote host:
 *
 *	 Note: You can specify a server host by using either an IPv4
 *	       address in dotted-decimal notation (e.g. 16.20.10.56)
 *	       or a host domain name (e.g. serverhost.hp.com).
 *
 *    2) The auxiliary server receives the hello service request, creates a
 *       process, then executes the commands in hello_run.com to  run  this
 *       server program.  This server program then logs  client  connection
 *	 information and client data to the service log before replying  to
 *	 the client host with a message of "Hello, world!".
 *
 */


/*
 * INCLUDE FILES:
 */

#include <descrip.h>		    /* define OpenVMS descriptors	    */

#include <efndef.h>		    /* define 'EFN$C_ENF' event flag	    */

#include <in.h>			    /* define internet related constants,   */
				    /* functions, and structures	    */
#include <inet.h>		    /* define network address info	    */
#include <iodef.h>		    /* define i/o function codes	    */

#include <ssdef.h>		    /* define system service status codes   */
#include <starlet.h>		    /* define system service calls	    */
#include <stdio.h>		    /* define standard i/o functions	    */
#include <stdlib.h>		    /* define standard library functions    */
#include <string.h>		    /* define string handling functions	    */
#include <stsdef.h>		    /* define condition value fields	    */

#include <tcpip$inetdef.h>	    /* define tcp/ip network constants,	    */
				    /* structures, and functions	    */


/*
 * STRUCTURE DEFINITIONS:
 */

struct iosb
    {					/* i/o status block		    */
    unsigned short status;		/* i/o completion status	    */
    unsigned short bytcnt;		/* bytes transferred if read/write  */
    void *details;			/* address of buffer or parameter   */
    };

struct itemlst_2
    {					/* item-list 2 descriptor/element   */
    unsigned short length;		/* length			    */
    unsigned short type;		/* parameter type		    */
    void *address;			/* address of item list		    */
    };

struct itemlst_3
    {					/* item-list 3 descriptor/element   */
    unsigned short length;		/* length			    */
    unsigned short type;		/* parameter type		    */
    void *address;			/* address of item list		    */
    unsigned int *retlen;		/* address of returned length	    */
    };

struct sockchar
    {					/* socket characteristics buffer    */
    unsigned short prot;		/* protocol			    */
    unsigned char type;			/* type				    */
    unsigned char af;			/* address format		    */
    };


/*
 * FORWARD REFERENCES:
 */

int  main( void );			/* server main			    */

	/* Server Main */

/*
 * FUNCTIONAL DESCRIPTION:
 *
 *    This is the server's main-line code. It handles all the tasks of the
 *    server including:  socket creation,  writing client connection data,
 *    and terminating client connections.
 *
 *    This example program implements a typical TCP IPv4 server using  QIO
 *    system  services to handle network i/o operations.  In addition,  it
 *    uses the auxiliary server to accept client connections.
 *
 *	1) To create a socket:
 *
 *	   sys$assign() and sys$qiow(IO$_SETMODE)
 *
 *	2) To transfer data:
 *
 *	   sys$qiow(IO$_WRITEVBLK)
 *
 *	3) To close and delete a socket:
 *
 *	   sys$qiow(IO$_DEACCESS) and sys$dassgn()
 *
 *    This function is invoked by the DCL "RUN" command (see below);  the
 *    function's  completion  status is interpreted by DCL and if needed,
 *    an error message is displayed.
 *
 * SYNOPSIS:
 *
 *    int main( void )
 *
 * FORMAL PARAMETERS:
 *
 *    ** None **
 *
 * IMPLICIT INPUTS:
 *
 *    ** None **
 *
 * IMPLICIT OUTPUTS:
 *
 *    ** None **
 *
 * FUNCTION VALUE:
 *
 *    completion status
 *
 * SIDE EFFECTS:
 *
 *    ** None **
 *
 */ 

int
main( void )
{
    struct iosb iosb;			/* i/o status block		    */

    unsigned int status;		/* system service return status	    */

    unsigned short conn_channel;	/* connect inet device i/o channel  */
    struct sockchar conn_sockchar;	/* connect socket char buffer	    */

    unsigned int client_retlen;		/* returned length of client socket */
					/* address structure		    */
    struct sockaddr_in client_addr;	/* client socket address structure  */
    struct itemlst_3 client_itemlst;	/* client item-list 3 descriptor    */

    char buf[] = "Hello, world!";	/* server data buffer		    */
    int  buflen = sizeof( buf );	/* length of server data buffer	    */

    $DESCRIPTOR( inet_device,		/* string descriptor with logical   */
		 "SYS$NET:"    );	/* name of internet pseudodevice    */

    /*
     * init connection socket characteristics buffer
     */

    conn_sockchar.prot = TCPIP$C_TCP;
    conn_sockchar.type = TCPIP$C_STREAM;
    conn_sockchar.af   = TCPIP$C_AUXS;

    /*
     * init client's item-list descriptor
     */

    memset( &client_itemlst, 0, sizeof(client_itemlst) );
    client_itemlst.length  = sizeof( client_addr );
    client_itemlst.address = &client_addr;
    client_itemlst.retlen  = &client_retlen;

    /*
     * init client's socket address structure
     */

    memset( &client_addr, 0, sizeof(client_addr) );

    /*
     * assign device socket
     */

    status = sys$assign( &inet_device,	    /* device name		    */
			 &conn_channel,     /* i/o channel		    */
			 0,		    /* access mode		    */
			 0		    /* not used			    */
		       );

    if ( !(status & STS$M_SUCCESS) )
	{
	printf( "Failed to assign i/o channel to TCPIP device\n" );
	exit( status );
	}

    /*
     * create connection socket
     */

    status = sys$qiow( EFN$C_ENF,	    /* event flag		    */
		       conn_channel,	    /* i/o channel		    */
		       IO$_SETMODE,	    /* i/o function code	    */
		       &iosb,		    /* i/o status block		    */
		       0,		    /* ast service routine	    */
		       0,		    /* ast parameter		    */
		       &conn_sockchar,      /* p1 - socket char buffer	    */
		       0,		    /* p2			    */
		       0,		    /* p3			    */
		       0,		    /* p4			    */
		       0,		    /* p5			    */
		       0		    /* p6			    */
		     );

    if ( status & STS$M_SUCCESS )
	status = iosb.status;

    if ( !(status & STS$M_SUCCESS) )
	{
	printf( "Failed to create socket\n" );
	exit( status );
	}

    /*
     * log this client connection
     */

    status = sys$qiow( EFN$C_ENF,	    /* event flag		    */
		       conn_channel,	    /* i/o channel		    */
		       IO$_SENSEMODE,	    /* i/o function code	    */
		       &iosb,		    /* i/o status block		    */
		       0,		    /* ast service routine	    */
		       0,		    /* ast parameter		    */
		       0,		    /* p1			    */
		       0,		    /* p2			    */
		       0,		    /* p3			    */
		       &client_itemlst,	    /* p4 - peer socket name	    */
		       0,		    /* p5			    */
		       0		    /* p6			    */
		     );

    if ( status & STS$M_SUCCESS )
	status = iosb.status;

    if ( !(status & STS$M_SUCCESS) )
	{
	printf( "Failed to accept client connection\n" );
	exit( status );
	}

    printf( "Accepted connection from host: %s, port: %d\n",
	    inet_ntoa(client_addr.sin_addr), ntohs(client_addr.sin_port)
	  );

    /*
     * connection established with a client;
     * now attempt to write on this connection
     */

    status = sys$qiow( EFN$C_ENF,	    /* event flag		    */
		       conn_channel,	    /* i/o channel		    */
		       IO$_WRITEVBLK,	    /* i/o function code	    */
		       &iosb,		    /* i/o status block		    */
		       0,		    /* ast service routine	    */
		       0,		    /* ast parameter		    */
		       buf,		    /* p1 - buffer address	    */
		       buflen,		    /* p2 - buffer length	    */
		       0,		    /* p3			    */
		       0,		    /* p4			    */
		       0,		    /* p5			    */
		       0		    /* p6			    */
		     );

    if ( status & STS$M_SUCCESS )
	status = iosb.status;

    if ( !(status & STS$M_SUCCESS) )
	{
	printf( "Failed to write data to client connection\n" );
	exit( status );
	}

    printf( "Data sent: %s\n", buf );	    /* output server's data buffer  */

    /*
     * close connection socket
     */

    status = sys$qiow( EFN$C_ENF,	    /* event flag		    */
		       conn_channel,	    /* i/o channel		    */
		       IO$_DEACCESS,	    /* i/o function code	    */
		       &iosb,		    /* i/o status block		    */
		       0,		    /* ast service routine	    */
		       0,		    /* ast parameter		    */
		       0,		    /* p1			    */
		       0,		    /* p2			    */
		       0,		    /* p3			    */
		       TCPIP$C_DSC_ALL,	    /* p4 - discard all packets	    */
		       0,		    /* p5			    */
		       0		    /* p6			    */
		     );

    if ( status & STS$M_SUCCESS )
	status = iosb.status;

    if ( !(status & STS$M_SUCCESS) )
	{
	printf( "Failed to close socket\n" );
	exit( status );
	}

    /*
     * deassign device socket
     */

    status = sys$dassgn( conn_channel );

    if ( !(status & STS$M_SUCCESS) )
	{
	printf( "Failed to deassign i/o channel to TCPIP device\n" );
	exit( status );
	}

    exit( EXIT_SUCCESS );
}