---
name: "YRemoveHost"
section: "3"
platform: "linux"
package: "liby-dev"
version: "2.14.5-7"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/YRemoveHost"
---

# YRemoveHost(3)

Y host access list removing

## NAME

YRemoveHost - Y host access list removing

## 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)](/return/1.md);

        /\* 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);\
 }

## SEE ALSO

[YIPUnion(3)](/YIPUnion/3.md) [YAddHost(3)](/YAddHost/3.md)