rtmp(3N)                                                 rtmp(3N)



NAME
     rtmp_netinfo - identify AppleTalk node and bridge addresses

SYNOPSIS
     #include <at/appletalk.h>
     cc [flags] files -lat [libraries]

     int rtmp_netinfo(fd, addr, bridge)
     int fd;
     at_inet_t *addr, *bridge;

DESCRIPTION
     This routine allows the caller to determine  node addresses.
     It uses the structure at_inet_t defined in <at/appletalk.h>:

     typedef struct at_inet {
          at_net          net;
          at_node         node;
          at_socket       socket;
     } at_inet_t;

     The at_inet_t structure specifies AppleTalk socket internet
     address.  The parameters are

     fd   An AppleTalk socket descriptor. If this parameter is
          -1, it is ignored; otherwise, upon return, the socket
          field in addr contains the socket number corresponding
          to fd.

     addr Pointer to an at_inet_t structure.  If this pointer is
          non-NULL, the AppleTalk network and node addresses are
          returned in the structure to which it points.  If fd is
          not -1, the socket field of this structure is filled;
          otherwise it is zero.  This parameter is ignored if it
          is NULL.

     bridge
          Pointer to an at_inet_t structure.  If this pointer is
          non-NULL, the AppleTalk network and addresses of a
          bridge known to DDP are returned in the structure to
          which it points. This parameter is ignored if it is
          NULL.  The socket field is meaningless and always
          contains zero on return.

     Either addr or bridge must be non-NULL.  rtmp_netinfo
     returns an error if both are NULL.

     The function returns zero if successful; otherwise, -1 is
     returned with a detailed error code in errno.






January 1992                                                    1

rtmp(3N)                                                 rtmp(3N)



STATUS MESSAGES AND VALUES
     The rtmp_netinfo program returns -1 on error with a detailed
     error code in errno:

     [EINVAL]
          Both addr and bridge are NULL

     See also the errors returned by the underlying DDP module.

SEE ALSO
     ddp(3N)

     Inside AppleTalk

     ``AppleTalk Programming Guide,'' in A/UX Network
     Applications Programming







































2                                                    January 1992