[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]

NAME
    ReadOrphan -- Get a packet for which there is no reader.

FUNCTION
    Get the next packet available that does not satisfy any then-pending
    CMD_READ requests. The data returned in the ios2_Data structure is
    normally the Data Link Layer packet type field and the packet data. If
    bit SANA2IOB_RAW is set in ios2_Flags, then the entire Data Link Layer
    packet, including both header and trailer information, will be
    returned.

IO REQUEST
    ios2_Command    - CMD_READORPHAN.
    ios2_Flags      - Supported flags are:
                            SANA2IOB_RAW
                            SANA2IOB_QUICK
    ios2_DataLength - Length of the Data to be sent.
    ios2_Data       - Abstract data structure which packet data is
                      contained in.

RESULTS
    ios2_Error      - Zero if successful; non-zero otherwise.
    ios2_WireError  - More specific error number.
    ios2_Flags      - The following flags may be returned:
                            SANA2IOB_RAW
                            SANA2IOB_BCAST
                            SANA2IOB_MCAST
    ios2_SrcAddr    - Source interface address of packet.
    ios2_DstAddr    - Destination interface address of packet.
    ios2_DataLength - Length of the Data to be sent.
    ios2_Data       - Abstract data structure which packet data is
                      contained in.

NOTES
    This is intended for debugging and management tools.  Protocols should
    not use this.

    As with 802.3 packets on an ethernet, to determine which protocol
    family the returned packet belongs to you may have to specify
    SANA2IOB_RAW to get the entire data link layer wrapper (which is where
    the protocol type may be kept). Notice this necessarily means that
    this cannot be done in a network interface independent fashion.  The
    driver will, however, fill in the PacketType field to the best of its
    ability.

SEE ALSO
    CMD_READ, CMD_WRITE

BUGS