ACE: OS_TLI.h Source File

00001 // -*- C++ -*-
00002 
00003 //=============================================================================
00004 /**
00005  *  @file   OS_TLI.h
00006  *
00007  *  $Id: OS_TLI.h 80826 2008-03-04 14:51:23Z wotte $
00008  *
00009  *  @author Doug Schmidt <schmidt@cs.wustl.edu>
00010  */
00011 //=============================================================================
00012 
00013 
00014 #ifndef ACE_OS_TLI_H
00015 # define ACE_OS_TLI_H
00016 # include /**/ "ace/pre.h"
00017 
00018 # include "ace/config-all.h"
00019 
00020 # if !defined (ACE_LACKS_PRAGMA_ONCE)
00021 #  pragma once
00022 # endif /* ACE_LACKS_PRAGMA_ONCE */
00023 
00024 # include "ace/OS_Errno.h"
00025 # include "ace/ACE_export.h"
00026 
00027 # if defined (ACE_EXPORT_MACRO)
00028 #  undef ACE_EXPORT_MACRO
00029 # endif
00030 # define ACE_EXPORT_MACRO ACE_Export
00031 
00032 # if !(defined(ACE_HAS_TLI) || defined(ACE_HAS_XTI))
00033 // Dummies to help compilation.
00034 struct t_call { };
00035 struct t_bind { };
00036 struct t_info { };
00037 struct t_optmgmt { };
00038 struct t_discon { };
00039 struct t_unitdata { };
00040 struct t_uderr { };
00041 struct netbuf { };
00042 
00043 # else /* !(ACE_HAS_TLI || ACE_HAS_XTI) */
00044 
00045 #   if defined (ACE_HAS_CONFLICTING_XTI_MACROS)
00046       // Make sure tcp.h gets included before sys/xti.h.
00047 #     include "ace/os_include/netinet/os_tcp.h"
00048 #     undef TCP_NODELAY
00049 #     undef TCP_MAXSEG
00050 #   endif /* ACE_HAS_CONFLICTING_XTI_MACROS */
00051 
00052 #   if defined (ACE_HAS_XTI)
00053 #     if defined (ACE_HAS_SYS_XTI_H)   /* Nonstandard header placement */
00054 #       define class ace_xti_class
00055 #       include /**/ <sys/xti.h>
00056 #       undef class
00057 #     elif defined (ACE_HAS_FORE_ATM_XTI)
00058 #       include /**/ <fore_xti/xti_user_types.h>
00059 #       include /**/ <fore_xti/xti.h>
00060 #       include /**/ <fore_xti/xti_atm.h>
00061 #       include /**/ <fore_xti/netatm/atm.h>
00062 #       include /**/ <fore_xti/ans.h>
00063 #     else
00064 #       include /**/ <xti.h>
00065 #     endif /* ACE_HAS_SYS_XTI_H */
00066 
00067       // The XTI API for obtaining local/peer addresses is t_getprotaddr().
00068       // The ACE API was developed in TLI days and so uses t_getname().
00069       // t_getname() has a type argument that specifies which address is
00070       // desired, local or peer, while t_getprotaddr() gets both at once.
00071       // t_getname() has values defined for the type, so these aren't defined
00072       // for XTI systems. So, define them here for ACE API users to use.
00073       // These values were taken from sys/tiuser.h on Solaris.
00074 #     if !defined (LOCALNAME)
00075 #       define LOCALNAME  0
00076 #     endif
00077 #     if !defined (REMOTENAME)
00078 #       define REMOTENAME 1
00079 #     endif
00080 
00081 #   else /* !ACE_HAS_XTI, so this is a TLI system */
00082 #     if !defined (ACE_HAS_TLI_PROTOTYPES)
00083 
00084 // Define ACE_TLI headers for systems that don't prototype them....
00085 extern "C"
00086 {
00087   int t_accept(int fildes, int resfd, struct t_call *call);
00088   char *t_alloc(int fildes, int struct_type, int fields);
00089   int t_bind(int fildes, struct t_bind *req, struct t_bind *ret);
00090   int t_close(int fildes);
00091   int t_connect(int fildes, struct t_call *sndcall,
00092                 struct t_call *rcvcall);
00093   void t_error(const char *errmsg);
00094   int t_free(char *ptr, int struct_type);
00095   int t_getinfo(int fildes, struct t_info *info);
00096   int t_getname (int fildes, struct netbuf *namep, int type);
00097   int t_getstate(int fildes);
00098   int t_listen(int fildes, struct t_call *call);
00099   int t_look(int fildes);
00100   int t_open(char *path, int oflag, struct t_info *info);
00101   int t_optmgmt(int fildes, struct t_optmgmt *req,
00102                 struct t_optmgmt *ret);
00103   int t_rcv(int fildes, char *buf, unsigned int nbytes, int *flags);
00104   int t_rcvconnect(int fildes, struct t_call *call);
00105   int t_rcvdis(int fildes, struct t_discon *discon);
00106   int t_rcvrel(int fildes);
00107   int t_rcvudata(int fildes, struct t_unitdata *unitdata, int *flags);
00108   int t_rcvuderr(int fildes, struct t_uderr *uderr);
00109   int t_snd(int fildes, const char *buf, unsigned int nbytes, int flags);
00110   int t_snddis(int fildes, struct t_call *call);
00111   int t_sndrel(int fildes);
00112   int t_sndudata(int fildes, struct t_unitdata *unitdata);
00113   int t_sync(int fildes);
00114   int t_unbind(int fildes);
00115 }
00116 #     endif /* !ACE_HAS_TLI_PROTOTYPES */
00117 
00118 #     if defined (ACE_HAS_TIUSER_H_BROKEN_EXTERN_C)
00119 extern "C" {
00120 #     endif /* ACE_HAS_TIUSER_H_BROKEN_EXTERN_C */
00121 #     if defined (ACE_HAS_TIUSER_H)
00122 #       include /**/ <tiuser.h>
00123 #     else
00124        /* What to do here??? Is there a tli.h? */
00125 #     endif /* ACE_HAS_TIUSER_H */
00126 #     if defined (ACE_HAS_TIUSER_H_BROKEN_EXTERN_C)
00127 }
00128 #     endif /* ACE_HAS_TIUSER_H_BROKEN_EXTERN_C */
00129 
00130 #     if defined (ACE_HAS_SVR4_TLI)
00131          // t_getname is a TLI extension added by some platforms before XTI
00132          // was widely available. However, it's not often in the system's
00133          // header files. Sun OS, for example, is like this.
00134          extern "C" int t_getname (int, struct netbuf *, int);
00135 #     endif /* ACE_HAS_SVR4_TLI */
00136 #   endif /* !ACE_HAS_XTI */
00137 
00138 # endif /* ACE_HAS_XTI || ACE_HAS_TLI */
00139 
00140 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
00141 
00142 // This hack is needed to get around an odd and hard-to-reproduce problem
00143 // with HP aC++. If struct sigaction is defined extern "C" and the sigaction
00144 // function in namespace ACE_OS, the compiler sometimes gets confused.
00145 // If we help it with this typedef, it's fine. User code should not use
00146 // the ACE typedef - it will be removed without warning as soon as we can
00147 // either drop support for the broken compilers or figure out how to reproduce
00148 // it so it can be reported to HP and fixed.
00149 // There's a similar hack in OS_TLI.h for struct t_optmgmt.
00150 // Also see ChangeLog entries:
00151 // Mon Jan 23 16:35:40 UTC 2006  Steve Huston  <shuston@riverace.com>
00152 // Mon Jan 23 22:08:56 UTC 2006  Steve Huston  <shuston@riverace.com>
00153 #if defined (__HP_aCC) && (__HP_aCC <= 37300)
00154 typedef extern "C" struct t_optmgmt  ACE_TOPTMGMT;
00155 typedef extern "C" struct t_bind  ACE_TBIND;
00156 #else
00157 typedef struct t_optmgmt ACE_TOPTMGMT;
00158 typedef struct t_bind  ACE_TBIND;
00159 #endif
00160 
00161 /**
00162  * @namespace ACE_OS
00163  *
00164  * @brief This class is a wrapper for the XTI/TLI operations
00165  *
00166  */
00167 namespace ACE_OS
00168 {
00169   // = A set of wrappers for XTI/TLI.
00170   ACE_NAMESPACE_INLINE_FUNCTION
00171   int t_accept (ACE_HANDLE fildes,
00172                 ACE_HANDLE resfd,
00173                 struct t_call
00174                 *call);
00175 
00176   ACE_NAMESPACE_INLINE_FUNCTION
00177   char *t_alloc (ACE_HANDLE fildes,
00178                  int struct_type,
00179                  int
00180                  fields);
00181 
00182   ACE_NAMESPACE_INLINE_FUNCTION
00183   int t_bind (ACE_HANDLE fildes,
00184               ACE_TBIND *req,
00185               ACE_TBIND *ret);
00186 
00187   ACE_NAMESPACE_INLINE_FUNCTION
00188   int t_close (ACE_HANDLE fildes);
00189 
00190   ACE_NAMESPACE_INLINE_FUNCTION
00191   int t_connect (ACE_HANDLE fildes,
00192                  struct t_call *sndcall,
00193                  struct t_call *rcvcall);
00194 
00195   ACE_NAMESPACE_INLINE_FUNCTION
00196   void t_error (const char *errmsg);
00197 
00198   ACE_NAMESPACE_INLINE_FUNCTION
00199   int t_free (char *ptr,
00200               int struct_type);
00201 
00202   ACE_NAMESPACE_INLINE_FUNCTION
00203   int t_getinfo (ACE_HANDLE fildes,
00204                  struct t_info *info);
00205 
00206   ACE_NAMESPACE_INLINE_FUNCTION
00207   int t_getname (ACE_HANDLE fildes,
00208                  struct netbuf *namep,
00209                  int type);
00210 
00211   ACE_NAMESPACE_INLINE_FUNCTION
00212   int t_getstate (ACE_HANDLE fildes);
00213 
00214   ACE_NAMESPACE_INLINE_FUNCTION
00215   int t_listen (ACE_HANDLE fildes,
00216                 struct t_call *call);
00217 
00218   ACE_NAMESPACE_INLINE_FUNCTION
00219   int t_look (ACE_HANDLE fildes);
00220 
00221   ACE_NAMESPACE_INLINE_FUNCTION
00222   ACE_HANDLE t_open (char *path,
00223                      int oflag,
00224                      struct t_info *info);
00225 
00226   ACE_NAMESPACE_INLINE_FUNCTION
00227   int t_optmgmt (ACE_HANDLE handle,
00228                  ACE_TOPTMGMT *req,
00229                  ACE_TOPTMGMT *ret);
00230 
00231   ACE_NAMESPACE_INLINE_FUNCTION
00232   int t_rcv (ACE_HANDLE fildes,
00233              char *buf,
00234              unsigned int nbytes,
00235              int *flags);
00236 
00237   ACE_NAMESPACE_INLINE_FUNCTION
00238   int t_rcvdis (ACE_HANDLE fildes,
00239                 struct t_discon *discon);
00240 
00241   ACE_NAMESPACE_INLINE_FUNCTION
00242   int t_rcvrel (ACE_HANDLE fildes);
00243 
00244   ACE_NAMESPACE_INLINE_FUNCTION
00245   int t_rcvudata (ACE_HANDLE fildes,
00246                   struct t_unitdata *unitdata,
00247                   int *flags);
00248 
00249   ACE_NAMESPACE_INLINE_FUNCTION
00250   int t_rcvuderr (ACE_HANDLE fildes,
00251                   struct t_uderr *uderr);
00252 
00253   ACE_NAMESPACE_INLINE_FUNCTION
00254   int t_snd (ACE_HANDLE fildes,
00255              const char *buf,
00256              unsigned int nbytes,
00257              int flags);
00258 
00259   ACE_NAMESPACE_INLINE_FUNCTION
00260   int t_snddis (ACE_HANDLE fildes,
00261                 struct t_call *call);
00262 
00263   ACE_NAMESPACE_INLINE_FUNCTION
00264   int t_sndrel (ACE_HANDLE fildes);
00265 
00266   ACE_NAMESPACE_INLINE_FUNCTION
00267   int t_sync (ACE_HANDLE fildes);
00268 
00269   ACE_NAMESPACE_INLINE_FUNCTION
00270   int t_unbind (ACE_HANDLE fildes);
00271 
00272 } /* namespace ACE_OS */
00273 
00274 ACE_END_VERSIONED_NAMESPACE_DECL
00275 
00276 # if defined (ACE_HAS_INLINED_OSCALLS)
00277 #   if defined (ACE_INLINE)
00278 #     undef ACE_INLINE
00279 #   endif /* ACE_INLINE */
00280 #   define ACE_INLINE inline
00281 #   include "ace/OS_TLI.inl"
00282 # endif /* ACE_HAS_INLINED_OSCALLS */
00283 
00284 #include /**/ "ace/post.h"
00285 #endif /* ACE_OS_TLI_H */