| /********************************************************************** |
| // @@@ START COPYRIGHT @@@ |
| // |
| // Licensed to the Apache Software Foundation (ASF) under one |
| // or more contributor license agreements. See the NOTICE file |
| // distributed with this work for additional information |
| // regarding copyright ownership. The ASF licenses this file |
| // to you under the Apache License, Version 2.0 (the |
| // "License"); you may not use this file except in compliance |
| // with the License. You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, |
| // software distributed under the License is distributed on an |
| // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| // KIND, either express or implied. See the License for the |
| // specific language governing permissions and limitations |
| // under the License. |
| // |
| // @@@ END COPYRIGHT @@@ |
| **********************************************************************/ |
| /*
|
| * !GLU Result Status Definitions
|
| *
|
| * Generated by rsg from:
|
| *
|
| * $RCSfile: glu_rs.rsg $$Revision: 1.12 $$Date: 1999/05/21 08:38:44 $
|
| *
|
| */
|
| #ifndef GLU_RS_H
|
| #define GLU_RS_H
|
| /*
|
| * !Definition of GLU_status
|
| *
|
| */
|
|
|
| #include <idltype.h>
|
| typedef IDL_long GLU_status;
|
| /*
|
| *
|
| *
|
| * !GLU_SUCCESS
|
| *
|
| * - operation completed successfully
|
| *
|
| *
|
| * !GLU_UNKNOWN
|
| *
|
| * - unknown error
|
| *
|
| * An unexpected GLU error occured. This is probably a
|
| * protocol violation.
|
| *
|
| * !GLU_BADCIN
|
| *
|
| * - invalid CIN (interface description)
|
| *
|
| * An invalid interface description has been
|
| * encountered. This may be caused by incorrect IDL
|
| * constructions, eg. misconstructed compound unions.
|
| *
|
| * !GLU_BADEXCEPTIDX
|
| *
|
| * - exception index incompatible with operation
|
| * description
|
| *
|
| * An index refers to an exception which does not exist
|
| * in the CIN. This is probably a protocol error.
|
| *
|
| * !GLU_BADGLUHDR
|
| *
|
| * - invalid header
|
| *
|
| * An invalid header was encounterd whilst unpacking a
|
| * message. This is probably a protocol error.
|
| *
|
| * !GLU_BADHDRVERSION
|
| *
|
| * - invalid protocol version
|
| *
|
| * An error has been encountered on unpacking a message
|
| * header. This is probably a protocol error.
|
| *
|
| * !GLU_BADOPIDX
|
| *
|
| * - operation index incompatible with interface
|
| * description
|
| *
|
| * An index refers to an operation which does not exist
|
| * in the CIN. This is probably a protocol error.
|
| *
|
| * !GLU_BADPARAMIDX
|
| *
|
| * - parameter index incompatible with operation
|
| * description
|
| *
|
| * An index refers to an parameter which does not exist
|
| * in the CIN. This is probably a protocol error.
|
| *
|
| * !GLU_BADPREPBUF
|
| *
|
| * - prepared CIN is invalid
|
| *
|
| * "prep" is invalid. Either the memory is corrupt or
|
| * "GLU_INTERFACE_PREPARE" was not called.
|
| *
|
| * !GLU_BADPV
|
| *
|
| * - invalid parameter vector
|
| *
|
| * A bad parameter vector has been encountered. This is
|
| * probably a protocol error.
|
| *
|
| * !GLU_BADSEQSIZE
|
| *
|
| * - IDL sequence had invalid size
|
| *
|
| * While unmarshalling a parameter or exception, a
|
| * bounded sequence was encountered the length of which
|
| * was greater than the bound. This is probably a
|
| * protocol violation, because the sending ORB should
|
| * have checked the length.
|
| *
|
| * !GLU_BADSTRSIZE
|
| *
|
| * - IDL string had invalid size
|
| *
|
| * An attempt to operate on a string failed because the
|
| * actual size of the string exceeds its declared size.
|
| *
|
| * !GLU_INITERR
|
| *
|
| * - GLU module initialization error
|
| *
|
| * An error occured whilst initialising GLU. Check that
|
| * installed software is complete.
|
| *
|
| * !GLU_LONGINBUF
|
| *
|
| * - input buffer too large (extraneous data)
|
| *
|
| * The message was unpacked successfully, but
|
| * "to_unpack_len" was greater than the data required to
|
| * successfully unmarshall the request. This is probably
|
| * a protocol violation.
|
| *
|
| * !GLU_NOSUCHOP
|
| *
|
| * - no such operation
|
| *
|
| * The operation specified in "request_header" could not
|
| * be found. Either the name was not found or the
|
| * operation synopsis did not match, i.e. the
|
| * operation's type signature defined in "prep" is not
|
| * the same as the type signature used to pack the
|
| * request.
|
| *
|
| * !GLU_NOTREQUEST
|
| *
|
| * - input buffer does not contain a request
|
| *
|
| * The header type is not GLU_TYPE_REQUEST. This status
|
| * is only returned if "GLU_HEADER_DEF" is called
|
| * implicitly.
|
| *
|
| * !GLU_NOTRESPONSE
|
| *
|
| * - input buffer does not contain a response
|
| *
|
| * No response was found on unpacking a response. This
|
| * is probably a protocol error.
|
| *
|
| * !GLU_SHORTINBUF
|
| *
|
| * - input buffer too small
|
| *
|
| * The message could not be unpacked, because
|
| * "to_unpack_len" was smaller than the data required.
|
| * This is probably a protocol violation.
|
| *
|
| * !GLU_SHORTOUTBUF
|
| *
|
| * - output buffer too small
|
| *
|
| * The message could not be unpacked because
|
| * "unpacked_len_max" was smaller than the space
|
| * required. "unpacked_len" contains the appropriate
|
| * length. Reallocate "unpacked_data" to be at least
|
| * "unpacked_len" bytes.
|
| *
|
| * !GLU_SHORTPREPBUF
|
| *
|
| * - buffer for prepared CIN too small
|
| *
|
| * The buffer into which the prepared CIN is to be
|
| * placed is too small. In order to allocate the buffer
|
| * dynamically with exactly the correct size you can
|
| * call "PCU_PREPARE" twice. On the first call
|
| * "max_prepbuf_len" is set to zero. "PCU_PREPARE"
|
| * returns status code PCU_SHORTPREPBUF and
|
| * "prepbuf_len" will contain the required "prepbuf"
|
| * size. The correct amount of memory can then be
|
| * allocated before calling "PCU_PREPARE" a second time
|
| * to prepare the CIN description.
|
| *
|
| * !GLU_SHORTPV
|
| *
|
| * - parameter vector too small
|
| *
|
| * "pv_len_max" is shorter than required to unpack all
|
| * the parameters for the operation. "*local_op_idx" is
|
| * valid. The correct size should be two plus the
|
| * parameter count for the operation.
|
| * GLU_GET_NR_PARAMETERS may be called to get the
|
| * parameter count. Note that the "result" is treated as
|
| * an "out" parameter and need not be handled specially.
|
| *
|
| * !GLU_TOOMANYMEMBERS
|
| *
|
| * - implementation limit: struct passed to operation has
|
| * too many fields
|
| *
|
| * The maximum number of members which may be defined in
|
| * an IDL structure has been exceeded. The IDL which
|
| * causes the problem will need to be fixed.
|
| *
|
| * !GLU_UNIMPLCONV
|
| *
|
| * - unimplemented conversion
|
| *
|
| * While unmarshalling a parameter or exception, a data
|
| * type was encountered that could not be converted to
|
| * the native format. This is likely to be caused by a
|
| * conversion between two different floating point
|
| * (real) formats. For example, the client sent a NaN in
|
| * IEEE format and the server's native format is Tandem
|
| * format which doesn't have a representation for NaN.
|
| */
|
|
|
| #define GLU_SUCCESS ((GLU_status) 0)
|
| #define GLU_UNKNOWN ((GLU_status) 1)
|
| #define GLU_BADCIN ((GLU_status) 2)
|
| #define GLU_SHORTPREPBUF ((GLU_status) 3)
|
| #define GLU_BADPREPBUF ((GLU_status) 4)
|
| #define GLU_BADOPIDX ((GLU_status) 5)
|
| #define GLU_SHORTOUTBUF ((GLU_status) 6)
|
| #define GLU_BADSEQSIZE ((GLU_status) 7)
|
| #define GLU_BADSTRSIZE ((GLU_status) 8)
|
| #define GLU_BADGLUHDR ((GLU_status) 9)
|
| #define GLU_NOSUCHOP ((GLU_status) 10)
|
| #define GLU_SHORTINBUF ((GLU_status) 11)
|
| #define GLU_LONGINBUF ((GLU_status) 12)
|
| #define GLU_SHORTPV ((GLU_status) 13)
|
| #define GLU_BADPV ((GLU_status) 14)
|
| #define GLU_UNIMPLCONV ((GLU_status) 15)
|
| #define GLU_BADHDRVERSION ((GLU_status) 16)
|
| #define GLU_INITERR ((GLU_status) 17)
|
| #define GLU_TOOMANYMEMBERS ((GLU_status) 18)
|
| #define GLU_NOTREQUEST ((GLU_status) 19)
|
| #define GLU_NOTRESPONSE ((GLU_status) 20)
|
| #define GLU_BADEXCEPTIDX ((GLU_status) 21)
|
| #define GLU_BADPARAMIDX ((GLU_status) 22)
|
|
|
| #ifdef __cplusplus
|
| extern "C" {
|
| #endif
|
| /*
|
| GLU_STATUS_TO_TEXT converts a result status to a string.
|
|
|
| <rs> result status to convert
|
|
|
| <=description> human-readable string for "rs"
|
| */
|
| extern
|
| char *
|
| GLU_STATUS_TO_TEXT(GLU_status rs);
|
|
|
| #ifdef __cplusplus
|
| }
|
| #endif
|
| #endif /* GLU_RS_H */
|
