dflthost(PCI)                  6 January 1993                  dflthost(PCI)


 Name

    dflthost - get/set the current host for PCILIB IPC functions

 Syntax


    #include <pcilib.h>


    #include <memmdl.h>

    int dflthost( drvnum )
    int drvnum


 Description

    dflthost allows the user to read and/or set which host is used for per-
    forming PCILIB IPC operations.  dflthost selects the host corresponding
    to the virtual drive indicated by drvnum (A:= 1, B:= 2, etc.)  (This vir-
    tual drive may or may not be logged into a host.)  Initially, the host
    corresponding to the first virtual drive is selected.

    If drvnum is 0, or any value that does not correspond to a virtual drive,
    then the current default host is not changed.  This option can be used to
    get the current default host.

    If a user program changes the default host, it should restore it to its
    original value before exiting.

 Return value

    dflthost always returns what the current default host was before the call
    was made.  The return value is an integer assigned as A:= 1, B:= 2, etc.

 Example


               :
               :
       int lastHost, setHost;
               :
               :
       /*
       ** Change Current Default Host
       ** to drive D: (4)
       */
       setHost = 4;
       if ( (lastHost = dflthost(setHost)) == 0 )
          errorHandler();
       else
          printf("Previous Host = %d, Current Host = %d", lastHost, setHost);


 See also

    msgctl(PCI), msgget(PCI), msgrcv(PCI), msgsnd(PCI), semctl(PCI),
    semget(PCI), semop(PCI)