SYNTAX

#include <Y2/Y.h>
#include <Y2/Ylib.h>

int YRemoveHost(

        YConnection *connection,

        YIPUnion *ip
)

ARGUMENTS

connection

Specifies the connection to the Y server, obtained by a call to YOpenConnection.

ip

Specifies the ip address of the host machine. See YIPUnion for more information about this structure.

DESCRIPTION

The YRemoveHost function removes the specified IP address ip from the Y server's list of allowed hosts. If the IP address ip never existed in the Y server's list of allowed hosts then no operation will be performed.

RETURN VALUE

The YRemoveHost function returns 0 on success or -1 on failure. It will return success even if the specified address was never in the Y server's list.

EXAMPLE

#include <stdio.h>
#include <Y2/Y.h>
#include <Y2/Ylib.h>

int main(int argc, char *argv[])
{

        YIPUnion ip;

        YConnection *con = YOpenConnection(

                "/usr/sbin/starty",

                "127.0.0.1:9433"

        );

        if(con == NULL)

                return(1);

        /* 207.200.89.225 */

        ip.charaddr[0] = 207;

        ip.charaddr[1] = 200;

        ip.charaddr[2] = 89;

        ip.charaddr[3] = 225;

        if(YRemoveHost(con, &ip))

                printf("Error.\n");

        else

                printf("Success!\n");

        YCloseConnection(con, False);

        return(0);
}