Man Linux: Main Page and Category List

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);

               /* 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) YAddHost(3)