C / C++ / MFC

/*-----------------------------------------------------------------------
 * clientserver.x
 *-----------------------------------------------------------------------
 */
 
const msgstring_size = 1000;	/* maximum size of the message string */

struct message		/* structure declared here to define the messaage
                        /*structure */
{	String usr_name;
	String msg;
	int svc_index;
	int msg_num;
	int msg_subject;
	String msg_author;
	boolean read;	/* to distinguish read pr unread messages*/
};
struct header
{
	String subject;
	String author;
};

/*-----------------------------------------------------------------------
 * clntsvc_pg - program definition
 *-----------------------------------------------------------------------
 */
 program clntsvcPROG  /*    program name  */
{  
	version clntsvc_pgVERS	/* declaration of version 1*/
	{
		void login(usr_name)          = 1 ; /* First procedure  */
		void connect_svc(svc_index)   = 2 ; /* Second procedure */
		void viewlist(void)           = 3 ; /* Third procedure  */
		void post_msg(msg)            = 4 ; /* Fourth procedure */
 		void delete(msg_num)          = 5 ; /* Fifth procedure  */
		void read(msg_num)            = 6 ; /* Sixth procedure  */
		void start_svc(svc_index)     = 7 ; /* Seventh procedure*/
		void msg_exp(msg_num)         = 8 ; /* Eighth procedure */
		void svc_crash(svc_index)     = 9 ; /* Ninth  procedure */
		void clnt_crash(void)         = 10; /* Tenth procedure  */
	} = 1;			/* definition of the program version  */
	version clntsvc_pgVERS2 /* declaration of version 2*/
	{
		void delete(int* msg_num)    = 1; /* First procedure */
	} = 2;                  /* definition of the program version  */
} = 0x30090949;                /* program number that must be unique */

Initial design document


 « News service application »


1.	Program Files

q	Files common to both the client and the server

-	Makefile : Used to compile the client and the server
-	clientserver.x : RPC specification file used by rpcgen
-	clientserver.h : Header file generated by rpcgen
-	clientserver_clnt.c : Client code generated by rpgen
-	clientserver_svc.c : Server code generated by rpgen
-	clientserver_xdr.c : XDR conversion file generated by rpcgen

q	Client specific files

-	mrn.c : Client main program
-	mrn_cif.c : Client interface routines
-	mrn : Client executable

q	Server specific files

-	mserver.c : Application server code
-	mserver_sif.c : Server interface routines
-	mserver : Server executable

q	Crasher specific files

-	mcrash.c : Application crasher code
-	mcrash_cif.c : Crasher interface routines
-	mcrash : Crasher executable




2.	Makefile

#
# Makefile for news service application (conventional and RPC)
#
all :            mrn          mserver         mcrash
install :       all
                   @echo nothing to install

clean :         rm    *.o   clientserver.h   clientserver_xdr.c  clientserver_clnt.c   clientserver_svc.c  mrn  mserver
                            mcrash
#
# Dependencies for files generated by rpcgen
#
clientserver_clnt.c :      clientserver.h     clientserver.x
clientserver_xdr.c  :      clientserver.h     clientserver.x
clientserver_svc.c  :      clientserver.h     clientserver.x

clientserver.h          :      clientserver.x

                             rpcgen      clientserver.x
#
# Link client-side files for RPC version
#
mrn :   clientserver_clnt.o  mrn_cif.o   clientserver_xdr.o    mrn.o
            gcc  -o   mrn   clientserver_clnt.o   mrn_cif.o  mrn.o  clientserver_xdr.o    -lnsl
   
#
# Link server-side files for RPC version
#
mserver :  clientserver_svc.o  mserver_sif.o  mserver.o   clientserver_xdr.o 
                 gcc   -o   mserver   clientserver_svc.o  mserver_sif.o  mserver.o  clientserver_xdr.o   -lnsl

#
# Link crasher-side files for RPC version
#
mcrasher :  clientserver_svc.o  mcrasher_cif.o  mcrasher.o   clientserver_xdr.o 
            gcc   -o   mcrasher  clientserver_svc.o  mcrasher_cif.o  mcrasher.o  clientserver_xdr.o   -lnsl
 
#
# Individual object file dependencies
#
clientserver_clnt.o :  clientserver_clnt.c     clientserver.h   clientserver.x
                                               gcc  -c   clientserver_clnt.c 

clientserver_svc.o :  clientserver_svc.c     clientserver.h   clientserver.x
                                              gcc  -c   clientserver_svc.c 

clientserver_xdr.o :  clientserver_xdr.c     clientserver.h   clientserver.x
                                              gcc  -c   clientserver_xdr.c 

mrn.o :        mrn.c           clientserver.h   clientserver.x
                                        gcc  -c   mrn.c 

mrn_cif.o :  mrn_cif.c     clientserver.h   clientserver.x
                                        gcc  -c   mrn_cif.c 

mserver.o :        mserver.c           clientserver.h   clientsserver.x
                                                     gcc  -c   mrn.c 

mserver_sif.o :  mserver_cif.c     clientserver.h   clientserver.x
                                                     gcc  -c   mrn_cif.c 
mcrasher.o :  mcrasher.c         clientserver.h     clientserver.x
                                                gcc  -c    mcrasher.c

mcrasher_cif.o :  mcrasher_cif.c         clientserver.h     clientserver.x
                                                gcc  -c    mcrasher_cif.c



3.	RPC specification file

const msgstring_size = 1000;    /* maximum size of the message string */

struct message          /* structure declared here to define the message
                                     /*structure */
{       
  String usr_name;
        String msg;
        int svc_index;
        int msg_num;
        int msg_subject;
        String msg_author;
        boolean read;   /* to distinguish read pr unread messages*/
};
struct header
{
        String subject;
        String author;
};

/*-----------------------------------------------------------------------
* clntsvc_pg - program definition
 *-----------------------------------------------------------------------
 */
 program clntsvcPROG  /*    program name  */
{
        version clntsvc_pgVERS  /* declaration of version 1*/
        {
                void login(String)      = 1 ; /* First procedure  */
                void connect_svc(int)   = 2 ; /* Second procedure */
                void viewlist(void)     = 3 ; /* Third procedure  */
		void post_msg(String)   = 4 ; /* Fourth procedure */
                void delete(int)        = 5 ; /* Fifth procedure  */
                void read(int)          = 6 ; /* Sixth procedure  */
                void start_svc(int)     = 7 ; /* Seventh procedure*/
                void msg_exp(int)       = 8 ; /* Eighth procedure */
                void svc_crash(int)     = 9 ; /* Ninth  procedure */
                void clnt_crash(void)   = 10; /* Tenth procedure  */
        } = 1;                  /* Definition of the program version  */

} = 0x30090949;                /* Program number that must be unique */

	The first procedure is used to login as a user 
The second is to connect to a server.
The third procedure is to view list of available messages.
The fourth procedure is for posting messages.
The fifth procedure is for deleting messages read or unread.
The sixth procedure is for reading messages.
The seventh procedure is to start the server.
The eighth procedure is to handle the expiration of messages.
The ninth procedure is to handle crashing server.
The tenth procedure is to handle crashing client.

4.	Running the program


To start the server application, enter: mserver
To start a client application, enter: mrn [hostname]

#
# Makefile for example bank application (conventional and RPC)
#
all:
	client server

install:	
	all
	@echo nothing to install.

clean:
rm *.o clientserver.h clientserver_xdr.c clientserver_clnt.c 
       clientserver_svc.c client server

#
# Dependencies for files generated by rpcgen
#
clientserver_clnt.c:	clientserver.h clientserver.x

clientserver_svc.c:	clientserver.h clientserver.x

clientserver_xdr.c:	clientserver.h clientserver.x

clientserver.h:	clientserver.x
		rpcgen clientserver.x

#
# Link client-side files for RPC version
#
bank:		bank_clnt.o bank_cif.o bank.o bank_xdr.o
		gcc -o bank bank_clnt.o bank_cif.o bank.o \
		bank_xdr.o -lnsl

#
# Link server-side files for RPC version
#
server:		clientserver_svc.o clientserver_sif.o clientserver_srp.o 
                clientserver_xdr.o
		gcc -o server clientserver_svc.o clientserver_sif.o
                clientserver_srp.o \
		clientserver_xdr.o -lnsl

#
# Individual object file dependencies
#
clientserver.o:	clientserver.c clientserver.h clientserver.x
		gcc -c clientserver.c

clientserver_clnt.o:	clientserver_clnt.c clientserver.h clientserver.x
		gcc -c clientserver_clnt.c

clientserver_svc.o:	clientserver_svc.c clientserver.h clientserver.x
		gcc -c clientserver_svc.c

clientserver_xdr.o:	clientserver_xdr.c clientserver.h clientserver.x
		gcc -c clientserver_xdr.c

clientserver_cif.o:	clientserver_cif.c clientserver.h clientserver.x
		gcc -c clientserver_cif.c

clientserver_sif.o:	clientserver_sif.c clientserver.h clientserver.x
		gcc -c clientserver_sif.c

clientserver_srp.o:	clientserver_srp.c clientserver.h clientserver.x
		gcc -c clientserver_srp.c