123 lines
4.1 KiB
C
123 lines
4.1 KiB
C
/*
|
|
* Copyright 2010 Tilera Corporation. All Rights Reserved.
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation, version 2.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
|
|
* NON INFRINGEMENT. See the GNU General Public License for
|
|
* more details.
|
|
*/
|
|
|
|
/**
|
|
* Error codes returned from NetIO routines.
|
|
*/
|
|
|
|
#ifndef __NETIO_ERRORS_H__
|
|
#define __NETIO_ERRORS_H__
|
|
|
|
/**
|
|
* @addtogroup error
|
|
*
|
|
* @brief The error codes returned by NetIO functions.
|
|
*
|
|
* NetIO functions return 0 (defined as ::NETIO_NO_ERROR) on success, and
|
|
* a negative value if an error occurs.
|
|
*
|
|
* In cases where a NetIO function failed due to a error reported by
|
|
* system libraries, the error code will be the negation of the
|
|
* system errno at the time of failure. The @ref netio_strerror()
|
|
* function will deliver error strings for both NetIO and system error
|
|
* codes.
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
/** The set of all NetIO errors. */
|
|
typedef enum
|
|
{
|
|
/** Operation successfully completed. */
|
|
NETIO_NO_ERROR = 0,
|
|
|
|
/** A packet was successfully retrieved from an input queue. */
|
|
NETIO_PKT = 0,
|
|
|
|
/** Largest NetIO error number. */
|
|
NETIO_ERR_MAX = -701,
|
|
|
|
/** The tile is not registered with the IPP. */
|
|
NETIO_NOT_REGISTERED = -701,
|
|
|
|
/** No packet was available to retrieve from the input queue. */
|
|
NETIO_NOPKT = -702,
|
|
|
|
/** The requested function is not implemented. */
|
|
NETIO_NOT_IMPLEMENTED = -703,
|
|
|
|
/** On a registration operation, the target queue already has the maximum
|
|
* number of tiles registered for it, and no more may be added. On a
|
|
* packet send operation, the output queue is full and nothing more can
|
|
* be queued until some of the queued packets are actually transmitted. */
|
|
NETIO_QUEUE_FULL = -704,
|
|
|
|
/** The calling process or thread is not bound to exactly one CPU. */
|
|
NETIO_BAD_AFFINITY = -705,
|
|
|
|
/** Cannot allocate memory on requested controllers. */
|
|
NETIO_CANNOT_HOME = -706,
|
|
|
|
/** On a registration operation, the IPP specified is not configured
|
|
* to support the options requested; for instance, the application
|
|
* wants a specific type of tagged headers which the configured IPP
|
|
* doesn't support. Or, the supplied configuration information is
|
|
* not self-consistent, or is out of range; for instance, specifying
|
|
* both NETIO_RECV and NETIO_NO_RECV, or asking for more than
|
|
* NETIO_MAX_SEND_BUFFERS to be preallocated. On a VLAN or bucket
|
|
* configure operation, the number of items, or the base item, was
|
|
* out of range.
|
|
*/
|
|
NETIO_BAD_CONFIG = -707,
|
|
|
|
/** Too many tiles have registered to transmit packets. */
|
|
NETIO_TOOMANY_XMIT = -708,
|
|
|
|
/** Packet transmission was attempted on a queue which was registered
|
|
with transmit disabled. */
|
|
NETIO_UNREG_XMIT = -709,
|
|
|
|
/** This tile is already registered with the IPP. */
|
|
NETIO_ALREADY_REGISTERED = -710,
|
|
|
|
/** The Ethernet link is down. The application should try again later. */
|
|
NETIO_LINK_DOWN = -711,
|
|
|
|
/** An invalid memory buffer has been specified. This may be an unmapped
|
|
* virtual address, or one which does not meet alignment requirements.
|
|
* For netio_input_register(), this error may be returned when multiple
|
|
* processes specify different memory regions to be used for NetIO
|
|
* buffers. That can happen if these processes specify explicit memory
|
|
* regions with the ::NETIO_FIXED_BUFFER_VA flag, or if tmc_cmem_init()
|
|
* has not been called by a common ancestor of the processes.
|
|
*/
|
|
NETIO_FAULT = -712,
|
|
|
|
/** Cannot combine user-managed shared memory and cache coherence. */
|
|
NETIO_BAD_CACHE_CONFIG = -713,
|
|
|
|
/** Smallest NetIO error number. */
|
|
NETIO_ERR_MIN = -713,
|
|
|
|
#ifndef __DOXYGEN__
|
|
/** Used internally to mean that no response is needed; never returned to
|
|
* an application. */
|
|
NETIO_NO_RESPONSE = 1
|
|
#endif
|
|
} netio_error_t;
|
|
|
|
/** @} */
|
|
|
|
#endif /* __NETIO_ERRORS_H__ */
|