NAME    [Toc]    [Back]

       sockatmark  -  Test whether a socket is at the out-of-band
       mark

SYNOPSIS    [Toc]    [Back]

       #include <sys/socket.h>

       int sockatmark (
               int socket );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       The sockatmark function also supports POSIX.1g Draft  6.6.

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies the file descriptor associated with a socket.

DESCRIPTION    [Toc]    [Back]

       The sockatmark() function enables applications  to  determine
  which received data precede the out-of-band data and
       which data follow the out-of-band data.  The function uses
       the  file  descriptor  for  the socket to locate the data.
       Applications typically use this function  between  receive
       operations.

       The  sockatmark()  function  does not remove the mark from
       the stream.

RETURN VALUES    [Toc]    [Back]

       Upon  successful  completion,  the  sockatmark()  function
       returns  1  if the protocol has marked the data stream and
       all data preceding the mark have been read, or 0 (zero) if
       there  is  no  mark  or  if  data  precede the mark in the
       receive queue.

       If the sockatmark() function  fails,  a  value  of  -1  is
       returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       If  the  sockatmark()  function fails, errno may be set to
       one of the following values: The socket parameter is not a
       valid  file  descriptor.   The  socket  parameter does not
       specify a descriptor for a socket.

SEE ALSO    [Toc]    [Back]

       Functions: recv(2), recvmsg(2).

       Standards: standards(5).

       Network Programmer's Guide



                                                    sockatmark(3)