---

ACE Class Reference

Contains value added ACE methods that extend the behavior of the UNIX and Win32 OS calls. More...

#include <ACE.h>

Inheritance diagram for ACE:

[legend]Collaboration diagram for ACE:

[legend]List of all members.

Static Public Methods
u_int	major_version (void)
	e.g., the "5" in ACE 5.1.12. More...
u_int	minor_version (void)
	e.g., the "1" in ACE 5.1.12. More...
u_int	beta_version (void)
	e.g., the "12" in ACE 5.1.12. Returns 0 for "stable" (non-beta) releases. More...
const ACE_TCHAR *	compiler_name (void)
	E.g., the "SunPro C++" in SunPro C++ 4.32.0. More...
u_int	compiler_major_version (void)
	E.g., the "4" in SunPro C++ 4.32.0. More...
u_int	compiler_minor_version (void)
	E.g., the "32" in SunPro C++ 4.32.0. More...
u_int	compiler_beta_version (void)
	E.g., the "0" in SunPro C++ 4.32.0. More...
int	out_of_handles (int error)
	Check if error indicates the process being out of handles (file descriptors). More...
int	handle_timed_accept (ACE_HANDLE listener, ACE_Time_Value *timeout, int restart)
ACE_HANDLE	handle_timed_complete (ACE_HANDLE listener, const ACE_Time_Value *timeout, int is_tli=0)
int	set_handle_limit (int new_limit=-1)
int	max_handles (void)
ACE_TCHAR *	strenvdup (const ACE_TCHAR *str)
const char *	strend (const char *s)
	Returns a pointer to the "end" of the string, i.e., the character past the '\0'. More...
char *	strnew (const char *s)
	This method is just like <strdup>, except that it uses <operator new> rather than <malloc>. If <s> is NULL returns NULL rather than segfaulting... More...
void	strdelete (char *s)
	Delete the memory allocated by <strnew>. More...
char *	strndup (const char *str, size_t n)
	Create a fresh new copy of <str>, up to <n> chars long. Uses <ACE_OS::malloc> to allocate the new string. More...
char *	strnnew (const char *str, size_t n)
	Create a fresh new copy of <str>, up to <n> chars long. Uses <ACE_OS::malloc> to allocate the new string. More...
const wchar_t *	strend (const wchar_t *s)
wchar_t *	strnew (const wchar_t *s)
void	strdelete (wchar_t *s)
wchar_t *	strndup (const wchar_t *str, size_t n)
wchar_t *	strnnew (const wchar_t *str, size_t n)
const ACE_TCHAR *	execname (const ACE_TCHAR *pathname)
const ACE_TCHAR *	basename (const ACE_TCHAR *pathname, ACE_TCHAR delim=ACE_DIRECTORY_SEPARATOR_CHAR)
const ACE_TCHAR *	dirname (const ACE_TCHAR *pathname, ACE_TCHAR delim=ACE_DIRECTORY_SEPARATOR_CHAR)
ACE_TCHAR *	timestamp (ACE_TCHAR date_and_time[], int time_len, int return_pointer_to_first_digit=0)
pid_t	fork (const ACE_TCHAR *program_name=ACE_LIB_TEXT("< unknown >"), int avoid_zombies=0)
int	daemonize (const ACE_TCHAR pathname[]=ACE_LIB_TEXT("/"), int close_all_handles=ACE_DEFAULT_CLOSE_ALL_HANDLES, const ACE_TCHAR program_name[]=ACE_LIB_TEXT("< unknown >"))
size_t	round_to_pagesize (off_t length)
	Rounds the request to a multiple of the page size. More...
size_t	round_to_allocation_granularity (off_t len)
	Rounds the request to a multiple of the allocation granularity. More...
size_t	format_hexdump (const char *buffer, size_t size, ACE_TCHAR *obuf, size_t obuf_sz)
	Format buffer into printable format. This is useful for debugging. More...
u_long	hash_pjw (const char *str)
	Computes the hash value of <str> using the "Hash PJW" routine. More...
u_long	hash_pjw (const char *str, size_t len)
	Computes the hash value of <str> using the "Hash PJW" routine. More...
u_long	hash_pjw (const wchar_t *str)
	Computes the hash value of <str> using the "Hash PJW" routine. More...
u_long	hash_pjw (const wchar_t *str, size_t len)
	Computes the hash value of <str> using the "Hash PJW" routine. More...
u_long	crc32 (const char *str)
	Computes the ISO 8802-3 standard 32 bits CRC for the string (not for a file). More...
u_long	crc32 (const char *buf, ACE_UINT32 len)
	Computes the ISO 8802-3 standard 32 bits CRC for the given buffer (the length is included in the CRC). More...
u_long	crc32 (iovec *iov, int len)
	Computes the ISO 8802-3 standard 32 bits CRC for the @ len iovec buffers. More...
u_long	gcd (u_long x, u_long y)
	Euclid's greatest common divisor algorithm. More...
u_long	minimum_frame_size (u_long period1, u_long period2)
	Calculates the minimum enclosing frame size for the given values. More...
u_long	is_prime (const u_long n, const u_long min_factor, const u_long max_factor)
int	map_errno (int error)
	Map troublesome win32 errno values to values that standard C strerr function understands. Thank you Microsoft. More...
const ACE_TCHAR *	sock_error (int error)
	Returns a string containing the error message corresponding to a WinSock error. This works around an omission in the Win32 API... More...
int	process_active (pid_t pid)
int	terminate_process (pid_t pid)
void	unique_name (const void *object, ACE_TCHAR *name, size_t length)
u_long	log2 (u_long num)
	Computes the base 2 logarithm of <num>. More...
ACE_TCHAR	nibble2hex (u_int n)
	Hex conversion utility. More...
u_char	hex2byte (ACE_TCHAR c)
	Convert a hex character to its byte representation. More...
char	debug (void)
void	debug (char d)
int	select (int width, ACE_Handle_Set *readfds, ACE_Handle_Set *writefds=0, ACE_Handle_Set *exceptfds=0, const ACE_Time_Value *timeout=0)
	Wrapper facade for <select> that uses <ACE_Handle_Set>s. More...
int	select (int width, ACE_Handle_Set &readfds, const ACE_Time_Value *timeout=0)
	Wrapper facade for the most common use of <select> that uses <ACE_Handle_Set>s. More...
int	handle_read_ready (ACE_HANDLE handle, const ACE_Time_Value *timeout)
	Timed wait for handle to get read ready. More...
int	handle_write_ready (ACE_HANDLE handle, const ACE_Time_Value *timeout)
	Timed wait for handle to get write ready. More...
int	handle_exception_ready (ACE_HANDLE handle, const ACE_Time_Value *timeout)
	Timed wait for handle to get exception ready. More...
int	handle_ready (ACE_HANDLE handle, const ACE_Time_Value *timeout, int read_ready, int write_ready, int exception_ready)
	Timed wait for handle to get read, write, or exception ready. More...
int	enter_recv_timedwait (ACE_HANDLE handle, const ACE_Time_Value *timeout, int &val)
	Wait for <timeout> before proceeding to a <recv> operation. <val> keeps track of whether we're in non-blocking mode or not. More...
int	enter_send_timedwait (ACE_HANDLE handle, const ACE_Time_Value *timeout, int &val)
	Wait for <timeout> before proceeding to a <send> operation. <val> keeps track of whether we're in non-blocking mode or not. More...
void	record_and_set_non_blocking_mode (ACE_HANDLE handle, int &val)
	This makes sure that <handle> is set into non-blocking mode. <val> keeps track of whether were in non-blocking mode or not. More...
void	restore_non_blocking_mode (ACE_HANDLE handle, int val)
	Cleanup after a timed operation, restore the appropriate non-blocking status of <handle>. More...
I/O operations
Notes on common parameters: <handle> is the connected endpoint that will be used for I/O. <buf> is the buffer to write from or receive into. <len> is the number of bytes to transfer. The <timeout> parameter in the following methods indicates how long to blocking trying to transfer data. If <timeout> == 0, then the call behaves as a normal send/recv call, i.e., for blocking sockets, the call will block until action is possible; for non-blocking sockets, EWOULDBLOCK will be returned if no action is immediately possible. If <timeout> != 0, the call will wait until the relative time specified in *<timeout> elapses. The "_n()" I/O methods keep looping until all the data has been transferred. These methods also work for sockets in non-blocking mode i.e., they keep looping on EWOULDBLOCK. <timeout> is used to make sure we keep making progress, i.e., the same timeout value is used for every I/O operation in the loop and the timeout is not counted down. The return values for the "*_n()" methods match the return values from the non "_n()" methods and are specified as follows: On complete transfer, the number of bytes transferred is returned. On timeout, -1 is returned, errno == ETIME. On error, -1 is returned, errno is set to appropriate error. On EOF, 0 is returned, errno is irrelevant. On partial transfers, i.e., if any data is transferred before timeout/error/EOF, <bytes_transferred> will contain the number of bytes transferred. Methods with <iovec> parameter are I/O vector variants of the I/O operations. Methods with the extra <flags> argument will always result in <send> getting called. Methods without the extra <flags> argument will result in <send> getting called on Win32 platforms, and <write> getting called on non-Win32 platforms.
ssize_t	recv (ACE_HANDLE handle, void *buf, size_t len, int flags, const ACE_Time_Value *timeout=0)
ssize_t	t_rcv (ACE_HANDLE handle, void *buf, size_t len, int *flags, const ACE_Time_Value *timeout=0)
ssize_t	recv (ACE_HANDLE handle, void *buf, size_t len, const ACE_Time_Value *timeout=0)
ssize_t	recvmsg (ACE_HANDLE handle, struct msghdr *msg, int flags, const ACE_Time_Value *timeout=0)
ssize_t	recvfrom (ACE_HANDLE handle, char *buf, int len, int flags, struct sockaddr *addr, int *addrlen, const ACE_Time_Value *timeout=0)
ssize_t	recv_n (ACE_HANDLE handle, void *buf, size_t len, int flags, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
ssize_t	t_rcv_n (ACE_HANDLE handle, void *buf, size_t len, int *flags, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
ssize_t	recv_n (ACE_HANDLE handle, void *buf, size_t len, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
ssize_t	recv (ACE_HANDLE handle, size_t n,...)
	Receive into a variable number of pieces. More...
ssize_t	recvv (ACE_HANDLE handle, iovec *iov, int iovcnt, const ACE_Time_Value *timeout=0)
ssize_t	recvv_n (ACE_HANDLE handle, iovec *iov, int iovcnt, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
ssize_t	recv_n (ACE_HANDLE handle, ACE_Message_Block *message_block, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
ssize_t	send (ACE_HANDLE handle, const void *buf, size_t len, int flags, const ACE_Time_Value *timeout=0)
ssize_t	t_snd (ACE_HANDLE handle, const void *buf, size_t len, int flags, const ACE_Time_Value *timeout=0)
ssize_t	send (ACE_HANDLE handle, const void *buf, size_t len, const ACE_Time_Value *timeout=0)
ssize_t	sendmsg (ACE_HANDLE handle, const struct msghdr *msg, int flags, const ACE_Time_Value *timeout=0)
ssize_t	sendto (ACE_HANDLE handle, const char *buf, int len, int flags, const struct sockaddr *addr, int addrlen, const ACE_Time_Value *timeout=0)
ssize_t	send_n (ACE_HANDLE handle, const void *buf, size_t len, int flags, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
ssize_t	t_snd_n (ACE_HANDLE handle, const void *buf, size_t len, int flags, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
ssize_t	send_n (ACE_HANDLE handle, const void *buf, size_t len, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
ssize_t	send (ACE_HANDLE handle, size_t n,...)
	Varargs variant. More...
ssize_t	sendv (ACE_HANDLE handle, const iovec *iov, int iovcnt, const ACE_Time_Value *timeout=0)
ssize_t	sendv_n (ACE_HANDLE handle, const iovec *iov, int iovcnt, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
ssize_t	send_n (ACE_HANDLE handle, const ACE_Message_Block *message_block, const ACE_Time_Value *timeout=0, size_t *bytes_transferred=0)
	Send all the <message_block>s chained through their <next> and <cont> pointers. This call uses the underlying OS gather-write operation to reduce the domain-crossing penalty. More...
ssize_t	read_n (ACE_HANDLE handle, void *buf, size_t len, size_t *bytes_transferred=0)
ssize_t	write_n (ACE_HANDLE handle, const void *buf, size_t len, size_t *bytes_transferred=0)
ssize_t	write_n (ACE_HANDLE handle, const ACE_Message_Block *message_block, size_t *bytes_transferred=0)
	Write all the <message_block>s chained through their <next> and <cont> pointers. This call uses the underlying OS gather-write operation to reduce the domain-crossing penalty. More...
ssize_t	readv_n (ACE_HANDLE handle, iovec *iov, int iovcnt, size_t *bytes_transferred=0)
ssize_t	writev_n (ACE_HANDLE handle, const iovec *iov, int iovcnt, size_t *bytes_transferred=0)
Private Methods
	ACE_CLASS_IS_NAMESPACE (ACE)
Static Private Methods
ssize_t	recv_i (ACE_HANDLE handle, void *buf, size_t len)
ssize_t	recv_n_i (ACE_HANDLE handle, void *buf, size_t len, int flags, size_t *bytes_transferred)
ssize_t	recv_n_i (ACE_HANDLE handle, void *buf, size_t len, int flags, const ACE_Time_Value *timeout, size_t *bytes_transferred)
ssize_t	t_rcv_n_i (ACE_HANDLE handle, void *buf, size_t len, int *flags, size_t *bytes_transferred)
ssize_t	t_rcv_n_i (ACE_HANDLE handle, void *buf, size_t len, int *flags, const ACE_Time_Value *timeout, size_t *bytes_transferred)
ssize_t	recv_n_i (ACE_HANDLE handle, void *buf, size_t len, size_t *bytes_transferred)
ssize_t	recv_n_i (ACE_HANDLE handle, void *buf, size_t len, const ACE_Time_Value *timeout, size_t *bytes_transferred)
ssize_t	recvv_n_i (ACE_HANDLE handle, iovec *iov, int iovcnt, size_t *bytes_transferred)
ssize_t	recvv_n_i (ACE_HANDLE handle, iovec *iov, int iovcnt, const ACE_Time_Value *timeout, size_t *bytes_transferred)
ssize_t	send_i (ACE_HANDLE handle, const void *buf, size_t len)
ssize_t	send_n_i (ACE_HANDLE handle, const void *buf, size_t len, int flags, size_t *bytes_transferred)
ssize_t	send_n_i (ACE_HANDLE handle, const void *buf, size_t len, int flags, const ACE_Time_Value *timeout, size_t *bytes_transferred)
ssize_t	t_snd_n_i (ACE_HANDLE handle, const void *buf, size_t len, int flags, size_t *bytes_transferred)
ssize_t	t_snd_n_i (ACE_HANDLE handle, const void *buf, size_t len, int flags, const ACE_Time_Value *timeout, size_t *bytes_transferred)
ssize_t	send_n_i (ACE_HANDLE handle, const void *buf, size_t len, size_t *bytes_transferred)
ssize_t	send_n_i (ACE_HANDLE handle, const void *buf, size_t len, const ACE_Time_Value *timeout, size_t *bytes_transferred)
ssize_t	sendv_n_i (ACE_HANDLE handle, const iovec *iov, int iovcnt, size_t *bytes_transferred)
ssize_t	sendv_n_i (ACE_HANDLE handle, const iovec *iov, int iovcnt, const ACE_Time_Value *timeout, size_t *bytes_transferred)
Static Private Attributes
size_t	pagesize_ = 0
	Size of a VM page. More...
size_t	allocation_granularity_ = 0
	Size of allocation granularity. More...
u_long	crc_table_ []
	CRC table. More...
const ACE_TCHAR	hex_chars_ [] = ACE_LIB_TEXT ("0123456789abcdef")
	Hex characters. More...
char	debug_ = 0
	Are we debugging ACE? More...

---

Detailed Description

Contains value added ACE methods that extend the behavior of the UNIX and Win32 OS calls.

This class consolidates all these ACE static methods in a single place in order to manage the namespace better. These methods are put here rather than in ACE_OS in order to separate concerns.

Definition at line 51 of file ACE.h.

---

Member Function Documentation

ACE::ACE_CLASS_IS_NAMESPACE (  ACE    )  [private]

const ACE_TCHAR * ACE::basename (  const ACE_TCHAR *    pathname, ACE_TCHAR    delim = ACE_DIRECTORY_SEPARATOR_CHAR )  [static]

Returns the "basename" of a <pathname> separated by <delim>. For instance, the basename of "/tmp/foo.cpp" is "foo.cpp" when <delim> is '/'. Definition at line 543 of file ACE.cpp. References ACE_TCHAR, ACE_TRACE, and ACE_OS_String::strrchr. Referenced by ACE_Malloc_T< ACE_MEM_POOL_2, ACE_LOCK, ACE_CB >::ACE_Malloc_T, ACE_MT_MEM_IO::init, and ACE_Name_Options::process_name. { ACE_TRACE ("ACE::basename"); const ACE_TCHAR *temp = ACE_OS::strrchr (pathname, delim); if (temp == 0) return pathname; else return temp + 1; }

u_int ACE::beta_version (  void    )  [static]

e.g., the "12" in ACE 5.1.12. Returns 0 for "stable" (non-beta) releases. Definition at line 88 of file ACE.cpp. References ACE_BETA_VERSION. { return ACE_BETA_VERSION; }

u_int ACE::compiler_beta_version (  void    )  [static]

E.g., the "0" in SunPro C++ 4.32.0. Definition at line 124 of file ACE.cpp. { #ifdef ACE_CC_BETA_VERSION return ACE_CC_BETA_VERSION; #else return 0; #endif }

u_int ACE::compiler_major_version (  void    )  [static]

E.g., the "4" in SunPro C++ 4.32.0. Definition at line 104 of file ACE.cpp. { #ifdef ACE_CC_MAJOR_VERSION return ACE_CC_MAJOR_VERSION; #else return 0; #endif }

u_int ACE::compiler_minor_version (  void    )  [static]

E.g., the "32" in SunPro C++ 4.32.0. Definition at line 114 of file ACE.cpp. { #ifdef ACE_CC_MINOR_VERSION return ACE_CC_MINOR_VERSION; #else return 0; #endif }

const ACE_TCHAR * ACE::compiler_name (  void    )  [static]

E.g., the "SunPro C++" in SunPro C++ 4.32.0. Definition at line 94 of file ACE.cpp. { #ifdef ACE_CC_NAME return ACE_CC_NAME; #else return ""; #endif }

u_long ACE::crc32 (  iovec *    iov, int    len )  [static]

Computes the ISO 8802-3 standard 32 bits CRC for the @ len iovec buffers. Definition at line 488 of file ACE.cpp. References COMPUTE, iovec::iov_base, and iovec::iov_len. { register ACE_UINT32 crc = 0; int total_len = 0; for (int i = 0; i < len; ++i) { for (const char *p = (char *) iov[i].iov_base; p != (char *) iov[i].iov_base + iov[i].iov_len; ++p) COMPUTE (crc, *p); total_len += iov[i].iov_len; } // Include the length of the string. for (; total_len != 0; total_len >>= 8) COMPUTE (crc, total_len & 0xff); return ~crc; }

u_long ACE::crc32 (  const char *    buf, ACE_UINT32    len )  [static]

Computes the ISO 8802-3 standard 32 bits CRC for the given buffer (the length is included in the CRC). Definition at line 470 of file ACE.cpp. References COMPUTE. { register ACE_UINT32 crc = 0; for (const char *p = buffer; p != buffer + len; ++p) COMPUTE (crc, *p); // Include the length of the string. for (; len != 0; len >>= 8) COMPUTE (crc, len & 0xff); return ~crc; }

u_long ACE::crc32 (  const char *    str )  [static]

Computes the ISO 8802-3 standard 32 bits CRC for the string (not for a file). Definition at line 447 of file ACE.cpp. References COMPUTE. Referenced by ACE_Shared_Memory_Pool::ACE_Shared_Memory_Pool, and ACE_SV_Semaphore_Simple::name_2_key. { register ACE_UINT32 crc = 0; u_long len = 0; for (const char *p = string; *p != 0; ++p) { COMPUTE (crc, *p); ++len; } // Include the length of the string. for (; len != 0; len >>= 8) COMPUTE (crc, len & 0xff); return ~crc; }

int ACE::daemonize (  const ACE_TCHAR    pathname[] = ACE_LIB_TEXT("/"), int    close_all_handles = ACE_DEFAULT_CLOSE_ALL_HANDLES, const ACE_TCHAR    program_name[] = ACE_LIB_TEXT("< unknown >") )  [static]

Become a daemon process using the algorithm in Richard Stevens "Advanced Programming in the UNIX Environment." If <close_all_handles> is non-zero then all open file handles are closed. Definition at line 2950 of file ACE.cpp. References ACE_TCHAR, ACE_TRACE, ACE_OS::chdir, ACE_OS::close, ACE_OS::exit, ACE_OS::fork, max_handles, pid_t, ACE_OS::setsid, SIG_IGN, SIGHUP, ACE_OS::signal, and ACE_OS::umask. Referenced by ACE_Service_Config::start_daemon. { ACE_TRACE ("ACE::daemonize"); #if !defined (ACE_LACKS_FORK) pid_t pid = ACE_OS::fork (); if (pid == -1) return -1; else if (pid != 0) ACE_OS::exit (0); // Parent exits. // 1st child continues. ACE_OS::setsid (); // Become session leader. ACE_OS::signal (SIGHUP, SIG_IGN); pid = ACE_OS::fork (program_name); if (pid != 0) ACE_OS::exit (0); // First child terminates. // Second child continues. if (pathname != 0) // change working directory. ACE_OS::chdir (pathname); ACE_OS::umask (0); // clear our file mode creation mask. // Close down the I/O handles. if (close_all_handles) for (int i = ACE::max_handles () - 1; i >= 0; i--) ACE_OS::close (i); return 0; #else ACE_UNUSED_ARG (pathname); ACE_UNUSED_ARG (close_all_handles); ACE_UNUSED_ARG (program_name); ACE_NOTSUP_RETURN (-1); #endif /* ACE_LACKS_FORK */ }

ASYS_INLINE void ACE::debug (  char    d )  [static]

Definition at line 309 of file ACE.i. References debug_. { ACE::debug_ = c; }

ASYS_INLINE char ACE::debug (  void    )  [static]

Definition at line 303 of file ACE.i. References debug_. Referenced by ACE_WIN32_Asynch_Accept::accept, ACE_Dummy_Node::apply, ACE_Static_Node::apply, ACE_Dynamic_Node::apply, ACE_Remove_Node::apply, ACE_Resume_Node::apply, ACE_Suspend_Node::apply, ACE_Stream_Node::apply, ACE_DLL_Handle::close, ACE_Local_Name_Space::create_manager_i, ACE_Service_Type_Impl::fini, ACE_Service_Repository::fini, ACE_Naming_Context::fini, ACE_Service_Config::fini_svcs, ACE_WIN32_Proactor::handle_events, ACE_Acceptor< SVC_HANDLER, ACE_PEER_ACCEPTOR_2 >::handle_input, ACE_Naming_Context::init, ACE_Service_Config::initialize, ACE_SOCK_Dgram_Bcast::mk_broadcast, ACE_DLL_Handle::open, ACE_Service_Config::open_i, ACE_Service_Config::parse_args, ACE_WIN32_Proactor::post_completion, ACE_Service_Config::process_directive, ACE_Service_Config::process_file, ACE_WIN32_Asynch_Read_File::readv, ACE_WIN32_Asynch_Read_Stream::readv, ACE_Service_Config::reconfigure, ACE_WIN32_Asynch_Read_Dgram::recv, ACE_WIN32_Proactor::register_handle, ACE_Framework_Repository::remove_dll_components_i, ACE_WIN32_Asynch_Write_Dgram::send, ACE_WIN32_Asynch_Read_Stream::shared_read, ACE_WIN32_Asynch_Write_Stream::shared_write, ACE_WIN32_Asynch_Transmit_File::transmit_file, ACE_WIN32_Asynch_Write_File::writev, and ACE_WIN32_Asynch_Write_Stream::writev. { return ACE::debug_; }

const ACE_TCHAR * ACE::dirname (  const ACE_TCHAR *    pathname, ACE_TCHAR    delim = ACE_DIRECTORY_SEPARATOR_CHAR )  [static]

Returns the "dirname" of a <pathname>. For instance, the dirname of "/tmp/foo.cpp" is "/tmp" when <delim> is '/'. If <pathname> has no <delim> ".\0" is returned. This method does not modify <pathname> and is not reentrant. Definition at line 555 of file ACE.cpp. References ACE_TCHAR, ACE_TRACE, MAXPATHLEN, ACE_OS_String::strrchr, and ACE_OS_String::strsncpy. { ACE_TRACE ("ACE::dirname"); static ACE_TCHAR return_dirname[MAXPATHLEN + 1]; const ACE_TCHAR *temp = ACE_OS::strrchr (pathname, delim); if (temp == 0) { return_dirname[0] = '.'; return_dirname[1] = '\0'; return return_dirname; } else { // When the len is truncated, there are problems! This should // not happen in normal circomstances size_t len = temp - pathname + 1; if (len > (sizeof return_dirname / sizeof (ACE_TCHAR))) len = sizeof return_dirname / sizeof (ACE_TCHAR); ACE_OS::strsncpy (return_dirname, pathname, len); return return_dirname; } }

int ACE::enter_recv_timedwait (  ACE_HANDLE    handle, const ACE_Time_Value *    timeout, int &    val )  [static]

Wait for <timeout> before proceeding to a <recv> operation. <val> keeps track of whether we're in non-blocking mode or not. Definition at line 2441 of file ACE.cpp. References handle_read_ready, and record_and_set_non_blocking_mode. Referenced by recv, recvfrom, recvmsg, recvv, and t_rcv. { int result = ACE::handle_read_ready (handle, timeout); if (result == -1) return -1; ACE::record_and_set_non_blocking_mode (handle, val); return result; }

int ACE::enter_send_timedwait (  ACE_HANDLE    handle, const ACE_Time_Value *    timeout, int &    val )  [static]

Wait for <timeout> before proceeding to a <send> operation. <val> keeps track of whether we're in non-blocking mode or not. Definition at line 2458 of file ACE.cpp. References handle_write_ready, and record_and_set_non_blocking_mode. Referenced by send, sendmsg, sendto, sendv, and t_snd. { int result = ACE::handle_write_ready (handle, timeout); if (result == -1) return -1; ACE::record_and_set_non_blocking_mode (handle, val); return result; }

const ACE_TCHAR * ACE::execname (  const ACE_TCHAR *    pathname )  [static]

On Win32 returns <pathname> if it already ends in ".exe," otherwise returns a dynamically allocated buffer containing "<pathname>.exe". Always returns <pathname> on UNIX. Definition at line 255 of file ACE.cpp. References ACE_LIB_TEXT, ACE_NEW_RETURN, ACE_TCHAR, ACE_OS_String::strcpy, ACE_OS_String::strecpy, ACE_OS_String::strlen, and ACE_OS_String::strstr. { #if defined (ACE_WIN32) if (ACE_OS::strstr (old_name, ACE_LIB_TEXT (".exe")) == 0) { ACE_TCHAR *new_name; size_t size = ACE_OS::strlen (old_name) + ACE_OS::strlen (ACE_LIB_TEXT (".exe")) + 1; ACE_NEW_RETURN (new_name, ACE_TCHAR[size], 0); ACE_TCHAR *end = new_name; end = ACE_OS::strecpy (new_name, old_name); // Concatenate the .exe suffix onto the end of the executable. ACE_OS::strcpy (end, ACE_LIB_TEXT (".exe")); return new_name; } #endif /* ACE_WIN32 */ return old_name; }

pid_t ACE::fork (  const ACE_TCHAR *    program_name = ACE_LIB_TEXT("< unknown >"), int    avoid_zombies = 0 )  [static]

if <avoid_zombies> == 0 call <ACE_OS::fork> directly, else create an orphan process that's inherited by the init process; init cleans up when the orphan process terminates so we don't create zombies. Definition at line 2997 of file ACE.cpp. References ACE_OS::_exit, ACE_exitcode, ACE_TCHAR, ACE_OS::fork, pid_t, ACE_OS::waitpid, WEXITSTATUS, and WIFEXITED. Referenced by ACE_Process_Strategy::activate_svc_handler, and ACE_Process::spawn. { if (avoid_zombies == 0) return ACE_OS::fork (program_name); else { // This algorithm is adapted from an example in the Stevens book // "Advanced Programming in the Unix Environment" and an item in // Andrew Gierth's Unix Programming FAQ. It creates an orphan // process that's inherited by the init process; init cleans up // when the orphan process terminates. // // Another way to avoid zombies is to ignore or catch the // SIGCHLD signal; we don't use that approach here. pid_t pid = ACE_OS::fork (); if (pid == 0) { // The child process forks again to create a grandchild. switch (ACE_OS::fork (program_name)) { case 0: // grandchild returns 0. return 0; case -1: // assumes all errnos are < 256 ACE_OS::_exit (errno); default: // child terminates, orphaning grandchild ACE_OS::_exit (0); } } // Parent process waits for child to terminate. #if defined (ACE_HAS_UNION_WAIT) union wait status; if (pid < 0 || ACE_OS::waitpid (pid, &(status.w_status), 0) < 0) #else ACE_exitcode status; if (pid < 0 || ACE_OS::waitpid (pid, &status, 0) < 0) #endif /* ACE_HAS_UNION_WAIT */ return -1; // child terminated by calling exit()? if (WIFEXITED ((status))) { // child terminated normally? if (WEXITSTATUS ((status)) == 0) return 1; else errno = WEXITSTATUS ((status)); } else // child didn't call exit(); perhaps it received a signal? errno = EINTR; return -1; } }

size_t ACE::format_hexdump (  const char *    buffer, size_t    size, ACE_TCHAR *    obuf, size_t    obuf_sz )  [static]

Format buffer into printable format. This is useful for debugging. Definition at line 2509 of file ACE.cpp. References ACE_OS_String::ace_isprint, ACE_LIB_TEXT, ACE_TCHAR, ACE_TRACE, and ACE_OS::sprintf. Referenced by ACE_Log_Msg::log_hexdump. { ACE_TRACE ("ACE::format_hexdump"); u_char c; ACE_TCHAR textver[16 + 1]; // We can fit 16 bytes output in text mode per line, 4 chars per byte. size_t maxlen = (obuf_sz / 68) * 16; if (size > maxlen) size = maxlen; size_t i; size_t lines = size / 16; for (i = 0; i < lines; i++) { size_t j; for (j = 0 ; j < 16; j++) { c = (u_char) buffer[(i << 4) + j]; // or, buffer[i*16+j] ACE_OS::sprintf (obuf, ACE_LIB_TEXT ("%02x "), c); obuf += 3; if (j == 7) { ACE_OS::sprintf (obuf, ACE_LIB_TEXT (" ")); obuf++; } textver[j] = ACE_OS::ace_isprint (c) ? c : '.'; } textver[j] = 0; ACE_OS::sprintf (obuf, ACE_LIB_TEXT (" %s\n"), textver); while (*obuf != '\0') obuf++; } if (size % 16) { for (i = 0 ; i < size % 16; i++) { c = (u_char) buffer[size - size % 16 + i]; ACE_OS::sprintf (obuf, ACE_LIB_TEXT ("%02x "), c); obuf += 3; if (i == 7) { ACE_OS::sprintf (obuf, ACE_LIB_TEXT (" ")); obuf++; } textver[i] = ACE_OS::ace_isprint (c) ? c : '.'; } for (i = size % 16; i < 16; i++) { ACE_OS::sprintf (obuf, ACE_LIB_TEXT (" ")); obuf += 3; if (i == 7) { ACE_OS::sprintf (obuf, ACE_LIB_TEXT (" ")); obuf++; } textver[i] = ' '; } textver[i] = 0; ACE_OS::sprintf (obuf, ACE_LIB_TEXT (" %s\n"), textver); } return size; }

u_long ACE::gcd (  u_long    x, u_long    y )  [static]

Euclid's greatest common divisor algorithm. Definition at line 3159 of file ACE.cpp. Referenced by minimum_frame_size, and ACE_Get_Opt::permute_args. { if (y == 0) { return x; } else { return ACE::gcd (y, x % y); } }

ASYS_INLINE int ACE::handle_exception_ready (  ACE_HANDLE    handle, const ACE_Time_Value *    timeout )  [static]

Timed wait for handle to get exception ready. Definition at line 253 of file ACE.i. References handle_ready. { return ACE::handle_ready (handle, timeout, 0, 0, 1); }

ASYS_INLINE int ACE::handle_read_ready (  ACE_HANDLE    handle, const ACE_Time_Value *    timeout )  [static]

Timed wait for handle to get read ready. Definition at line 231 of file ACE.i. References handle_ready. Referenced by enter_recv_timedwait, recv_n_i, recvv_n_i, and t_rcv_n_i. { return ACE::handle_ready (handle, timeout, 1, 0, 0); }

int ACE::handle_ready (  ACE_HANDLE    handle, const ACE_Time_Value *    timeout, int    read_ready, int    write_ready, int    exception_ready )  [static]

Timed wait for handle to get read, write, or exception ready. Definition at line 2387 of file ACE.cpp. References ETIME, ACE_Handle_Set::fdset, ACE_OS::poll, ACE_OS::select, and ACE_Handle_Set::set_bit. Referenced by handle_exception_ready, handle_read_ready, and handle_write_ready. { #if defined (ACE_HAS_POLL) && defined (ACE_HAS_LIMITED_SELECT) ACE_UNUSED_ARG (write_ready); ACE_UNUSED_ARG (exception_ready); struct pollfd fds; fds.fd = handle; fds.events = read_ready ? POLLIN : POLLOUT; fds.revents = 0; int result = ACE_OS::poll (&fds, 1, timeout); #else ACE_Handle_Set handle_set; handle_set.set_bit (handle); // Wait for data or for the timeout to elapse. int select_width; # if defined (ACE_WIN64) // This arg is ignored on Windows and causes pointer truncation // warnings on 64-bit compiles. select_width = 0; # else select_width = int (handle) + 1; # endif /* ACE_WIN64 */ int result = ACE_OS::select (select_width, read_ready ? handle_set.fdset () : 0, // read_fds. write_ready ? handle_set.fdset () : 0, // write_fds. exception_ready ? handle_set.fdset () : 0, // exception_fds. timeout); #endif /* ACE_HAS_POLL && ACE_HAS_LIMITED_SELECT */ switch (result) { case 0: // Timer expired. errno = ETIME; /* FALLTHRU */ case -1: // we got here directly - select() returned -1. return -1; case 1: // Handle has data. /* FALLTHRU */ default: // default is case result > 0; return a // ACE_ASSERT (result == 1); return result; } }

int ACE::handle_timed_accept (  ACE_HANDLE    listener, ACE_Time_Value *    timeout, int    restart )  [static]

Wait up to <timeout> amount of time to passively establish a connection. This method doesn't perform the <accept>, it just does the timed wait... Definition at line 2872 of file ACE.cpp. References ACE_TRACE, ETIMEDOUT, EWOULDBLOCK, ACE_OS::poll, ACE_Time_Value::sec, ACE_OS::select, ACE_Handle_Set::set_bit, and ACE_Time_Value::usec. Referenced by ACE_TLI_Acceptor::accept, ACE_SPIPE_Acceptor::accept, and ACE_SOCK_Acceptor::shared_accept_start. { ACE_TRACE ("ACE::handle_timed_accept"); // Make sure we don't bomb out on erroneous values. if (listener == ACE_INVALID_HANDLE) return -1; #if defined (ACE_HAS_POLL) && defined (ACE_HAS_LIMITED_SELECT) struct pollfd fds; fds.fd = listener; fds.events = POLLIN; fds.revents = 0; #else // Use the select() implementation rather than poll(). ACE_Handle_Set rd_handle; rd_handle.set_bit (listener); #endif /* ACE_HAS_POLL && ACE_HAS_LIMITED_SELECT */ // We need a loop here if <restart> is enabled. for (;;) { #if defined (ACE_HAS_POLL) && defined (ACE_HAS_LIMITED_SELECT) int n = ACE_OS::poll (&fds, 1, timeout); #else int select_width; # if defined (ACE_WIN64) // This arg is ignored on Windows and causes pointer truncation // warnings on 64-bit compiles. select_width = 0; # else select_width = int (listener) + 1; # endif /* ACE_WIN64 */ int n = ACE_OS::select (select_width, rd_handle, 0, 0, timeout); #endif /* ACE_HAS_POLL && ACE_HAS_LIMITED_SELECT */ switch (n) { case -1: if (errno == EINTR && restart) continue; else return -1; /* NOTREACHED */ case 0: if (timeout != 0 && timeout->sec () == 0 && timeout->usec () == 0) errno = EWOULDBLOCK; else errno = ETIMEDOUT; return -1; /* NOTREACHED */ case 1: return 0; /* NOTREACHED */ default: errno = EINVAL; return -1; /* NOTREACHED */ } } ACE_NOTREACHED (return 0); }

ACE_HANDLE ACE::handle_timed_complete (  ACE_HANDLE    listener, const ACE_Time_Value *    timeout, int    is_tli = 0 )  [static]

Wait up to <timeout> amount of time to complete an actively established non-blocking connection. If <is_tli> is non-0 then we are being called by a TLI wrapper (which behaves slightly differently from a socket wrapper). Definition at line 2714 of file ACE.cpp. References ACE_TRACE, ECONNREFUSED, ETIME, EWOULDBLOCK, ACE_OS::getsockopt, ACE_Handle_Set::is_set, ACE_OS::poll, recv, ACE_OS::select, and ACE_Handle_Set::set_bit. Referenced by ACE_TLI_Connector::complete, and ACE_SOCK_Connector::complete. { ACE_TRACE ("ACE::handle_timed_complete"); #if !defined (ACE_WIN32) && defined (ACE_HAS_POLL) && defined (ACE_HAS_LIMITED_SELECT) struct pollfd fds; fds.fd = h; fds.events = POLLIN | POLLOUT; fds.revents = 0; #else ACE_Handle_Set rd_handles; ACE_Handle_Set wr_handles; rd_handles.set_bit (h); wr_handles.set_bit (h); #endif /* !ACE_WIN32 && ACE_HAS_POLL && ACE_HAS_LIMITED_SELECT */ #if defined (ACE_WIN32) // Winsock is different - it sets the exception bit for failed connect, // unlike other platforms, where the read bit is set. ACE_Handle_Set ex_handles; ex_handles.set_bit (h); #endif /* ACE_WIN32 */ int need_to_check = 0; int known_failure = 0; #if defined (ACE_WIN32) int n = ACE_OS::select (0, // Ignored on Windows: int (h) + 1, 0, wr_handles, ex_handles, timeout); #else # if defined (ACE_HAS_POLL) && defined (ACE_HAS_LIMITED_SELECT) int n = ACE_OS::poll (&fds, 1, timeout); # else int n = ACE_OS::select (int (h) + 1, rd_handles, wr_handles, 0, timeout); # endif /* ACE_HAS_POLL && ACE_HAS_LIMITED_SELECT */ #endif /* ACE_WIN32 */ // If we failed to connect within the time period allocated by the // caller, then we fail (e.g., the remote host might have been too // busy to accept our call). if (n <= 0) { if (n == 0 && timeout != 0) errno = ETIME; return ACE_INVALID_HANDLE; } // Usually, a ready-for-write handle is successfully connected, and // ready-for-read (exception on Win32) is a failure. On fails, we // need to grab the error code via getsockopt. On possible success for // any platform where we can't tell just from select() (e.g. AIX), // we also need to check for success/fail. #if defined (ACE_WIN32) ACE_UNUSED_ARG (is_tli); // On Win32, ex_handle set indicates a failure. We'll do the check // to try and get an errno value, but the connect failed regardless of // what getsockopt says about the error. if (ex_handles.is_set (h)) { need_to_check = 1; known_failure = 1; } #elif defined (VXWORKS) ACE_UNUSED_ARG (is_tli); // Force the check on VxWorks. The read handle for "h" is not set, // so "need_to_check" is false at this point. The write handle is // set, for what it's worth. need_to_check = 1; #else if (is_tli) # if defined (ACE_HAS_POLL) && defined (ACE_HAS_LIMITED_SELECT) need_to_check = (fds.revents & POLLIN) && !(fds.revents & POLLOUT); # else need_to_check = rd_handles.is_set (h) && !wr_handles.is_set (h); # endif /* ACE_HAS_POLL && ACE_HAS_LIMITED_SELECT */ else #if defined(AIX) // AIX is broken... both success and failed connect will set the // write handle only, so always check. need_to_check = 1; #else # if defined (ACE_HAS_POLL) && defined (ACE_HAS_LIMITED_SELECT) need_to_check = (fds.revents & POLLIN); # else need_to_check = rd_handles.is_set (h); # endif /* ACE_HAS_POLL && ACE_HAS_LIMITED_SELECT */ #endif /* AIX */ #endif /* ACE_WIN32 */ if (need_to_check) { #if defined (SOL_SOCKET) && defined (SO_ERROR) int sock_err = 0; int sock_err_len = sizeof (sock_err); int sockopt_ret = ACE_OS::getsockopt (h, SOL_SOCKET, SO_ERROR, (char *)&sock_err, &sock_err_len); if (sockopt_ret < 0) { h = ACE_INVALID_HANDLE; } if (sock_err != 0 || known_failure) { h = ACE_INVALID_HANDLE; errno = sock_err; } #else char dummy; // The following recv() won't block provided that the // ACE_NONBLOCK flag has not been turned off . n = ACE::recv (h, &dummy, 1, MSG_PEEK); // If no data was read/peeked at, check to see if it's because // of a non-connected socket (and therefore an error) or there's // just no data yet. if (n <= 0) { if (n == 0) { errno = ECONNREFUSED; h = ACE_INVALID_HANDLE; } else if (errno != EWOULDBLOCK && errno != EAGAIN) h = ACE_INVALID_HANDLE; } #endif } // 1. The HANDLE is ready for writing and doesn't need to be checked or // 2. recv() returned an indication of the state of the socket - if there is // either data present, or a recv is legit but there's no data yet, // the connection was successfully established. return h; }

ASYS_INLINE int ACE::handle_write_ready (  ACE_HANDLE    handle, const ACE_Time_Value *    timeout )  [static]

Timed wait for handle to get write ready. Definition at line 242 of file ACE.i. References handle_ready. Referenced by enter_send_timedwait, send_n_i, sendv_n_i, and t_snd_n_i. { return ACE::handle_ready (handle, timeout, 0, 1, 0); }

u_long ACE::hash_pjw (  const wchar_t *    str, size_t    len )  [static]

Computes the hash value of <str> using the "Hash PJW" routine. Definition at line 313 of file ACE.cpp. { u_long hash = 0; for (size_t i = 0; i < len; i++) { // @@ UNICODE: Does this function do the correct thing with wchar's? const wchar_t temp = str[i]; hash = (hash << 4) + (temp * 13); u_long g = hash & 0xf0000000; if (g) { hash ^= (g >> 24); hash ^= g; } } return hash; }

u_long ACE::hash_pjw (  const wchar_t *    str )  [static]

Computes the hash value of <str> using the "Hash PJW" routine. Definition at line 337 of file ACE.cpp. References hash_pjw, and ACE_OS_String::strlen. { return ACE::hash_pjw (str, ACE_OS::strlen (str)); }

u_long ACE::hash_pjw (  const char *    str, size_t    len )  [static]

Computes the hash value of <str> using the "Hash PJW" routine. Definition at line 284 of file ACE.cpp. { u_long hash = 0; for (size_t i = 0; i < len; i++) { const char temp = str[i]; hash = (hash << 4) + (temp * 13); u_long g = hash & 0xf0000000; if (g) { hash ^= (g >> 24); hash ^= g; } } return hash; }

u_long ACE::hash_pjw (  const char *    str )  [static]

Computes the hash value of <str> using the "Hash PJW" routine. Definition at line 306 of file ACE.cpp. References ACE_OS_String::strlen. Referenced by ACE_Filecache::create, ACE_Filecache::fetch, ACE_Filecache::finish, ACE_UNIX_Addr::hash, ACE_String_Base::hash, ACE_SString::hash, ACE_NS_String::hash, hash_pjw, and ACE_Filecache::remove. { return ACE::hash_pjw (str, ACE_OS::strlen (str)); }

ASYS_INLINE u_char ACE::hex2byte (  ACE_TCHAR    c )  [static]

Convert a hex character to its byte representation. Definition at line 292 of file ACE.i. References ACE_LIB_TEXT, and ACE_TCHAR. { if (isdigit (c)) return (u_char) (c - ACE_LIB_TEXT ('0')); else if (islower (c)) return (u_char) (10 + c - ACE_LIB_TEXT ('a')); else return (u_char) (10 + c - ACE_LIB_TEXT ('A')); }

u_long ACE::is_prime (  const u_long    n, const u_long    min_factor, const u_long    max_factor )  [static]

Function that can burn up noticeable CPU time: brute-force determination of whether number "n" is prime. Returns 0 if it is prime, or the smallest factor if it is not prime. min_factor and max_factor can be used to partition the work among threads. For just one thread, typical values are 2 and n/2. Definition at line 3217 of file ACE.cpp. { if (n > 3) for (u_long factor = min_factor; factor <= max_factor; ++factor) if (n / factor * factor == n) return factor; return 0; }

ASYS_INLINE u_long ACE::log2 (  u_long    num )  [static]

Computes the base 2 logarithm of <num>. Definition at line 272 of file ACE.i. Referenced by ACE_Log_Record::priority, and ACE_Log_Record::priority_name. { u_long log = 0; for (; num > 0; log++) num >>= 1; return log; }

u_int ACE::major_version (  void    )  [static]

e.g., the "5" in ACE 5.1.12. Definition at line 76 of file ACE.cpp. References ACE_MAJOR_VERSION. { return ACE_MAJOR_VERSION; }

int ACE::map_errno (  int    error )  [static]

Map troublesome win32 errno values to values that standard C strerr function understands. Thank you Microsoft. Definition at line 3144 of file ACE.cpp. Referenced by ACE_Log_Msg::log. { switch (error) { #if defined (ACE_WIN32) case WSAEWOULDBLOCK: return EAGAIN; // Same as UNIX errno EWOULDBLOCK. #endif /* ACE_WIN32 */ } return error; }

int ACE::max_handles (  void    )  [static]

Returns the maximum number of open handles currently permitted in this process. This maximum may be extended using <ACE::set_handle_limit>. Definition at line 3056 of file ACE.cpp. References ACE_TRACE, ACE_OS::getrlimit, and ACE_OS::sysconf. Referenced by ACE_Dev_Poll_Reactor::ACE_Dev_Poll_Reactor, ACE_Select_Reactor_T::ACE_Select_Reactor_T, ACE_POSIX_AIOCB_Proactor::check_max_aio_num, daemonize, and set_handle_limit. { ACE_TRACE ("ACE::max_handles"); #if defined (RLIMIT_NOFILE) && !defined (ACE_LACKS_RLIMIT) rlimit rl; int r = ACE_OS::getrlimit (RLIMIT_NOFILE, &rl); # if !defined (RLIM_INFINITY) if (r == 0) return rl.rlim_cur; #else if (r == 0 && rl.rlim_cur != RLIM_INFINITY) return rl.rlim_cur; // If == RLIM_INFINITY, fall through to the ACE_LACKS_RLIMIT sections # endif /* RLIM_INFINITY */ #endif /* RLIMIT_NOFILE && !ACE_LACKS_RLIMIT */ #if defined (_SC_OPEN_MAX) return ACE_OS::sysconf (_SC_OPEN_MAX); #elif defined (FD_SETSIZE) return FD_SETSIZE; #else ACE_NOTSUP_RETURN (-1); #endif /* _SC_OPEN_MAX */ }

u_long ACE::minimum_frame_size (  u_long    period1, u_long    period2 )  [static]

Calculates the minimum enclosing frame size for the given values. Definition at line 3174 of file ACE.cpp. References gcd. { // if one of the periods is zero, treat it as though it as // uninitialized and return the other period as the frame size if (0 == period1) { return period2; } if (0 == period2) { return period1; } // if neither is zero, find the greatest common divisor of the two periods u_long greatest_common_divisor = ACE::gcd (period1, period2); // explicitly consider cases to reduce risk of possible overflow errors if (greatest_common_divisor == 1) { // periods are relative primes: just multiply them together return period1 * period2; } else if (greatest_common_divisor == period1) { // the first period divides the second: return the second return period2; } else if (greatest_common_divisor == period2) { // the second period divides the first: return the first return period1; } else { // the current frame size and the entry's effective period // have a non-trivial greatest common divisor: return the // product of factors divided by those in their gcd. return (period1 * period2) / greatest_common_divisor; } }

u_int ACE::minor_version (  void    )  [static]

e.g., the "1" in ACE 5.1.12. Definition at line 82 of file ACE.cpp. References ACE_MINOR_VERSION. { return ACE_MINOR_VERSION; }

ASYS_INLINE ACE_TCHAR ACE::nibble2hex (  u_int    n )  [static]

Hex conversion utility. Definition at line 285 of file ACE.i. References hex_chars_. { // @@ UNICODE does this work? return ACE::hex_chars_[n & 0x0f]; }

int ACE::out_of_handles (  int    error )  [static]

Check if error indicates the process being out of handles (file descriptors). Definition at line 34 of file ACE.cpp. References EADDRNOTAVAIL, ENFILE, ENOBUFS, ENOSYS, ENOTSUP, and EOPNOTSUPP. Referenced by ACE_Handle_Gobbler::consume_handles. { // EMFILE is common to all platforms. if (error == EMFILE || #if defined (ACE_WIN32) // On Win32, we need to check for ENOBUFS also. error == ENOBUFS || #elif defined (HPUX) // On HPUX, we need to check for EADDRNOTAVAIL also. error == EADDRNOTAVAIL || #elif defined (linux) // On linux, we need to check for ENOENT also. error == ENOENT || // For RedHat5.2, need to check for EINVAL too. error == EINVAL || // Without threads check for EOPNOTSUPP error == EOPNOTSUPP || #elif defined (sun) // On sun, we need to check for ENOSR also. error == ENOSR || // Without threads check for ENOTSUP error == ENOTSUP || #elif defined (__FreeBSD__) // On FreeBSD we need to check for EOPNOTSUPP (LinuxThreads) or // ENOSYS (libc_r threads) also. error == EOPNOTSUPP || error == ENOSYS || #elif defined (__OpenBSD__) // OpenBSD appears to return EBADF. error == EBADF || #elif defined (__sgi) // irix error == ENOTSUP || #elif defined (DIGITAL_UNIX) // osf1 error == ENOTSUP || #endif /* ACE_WIN32 */ error == ENFILE) return 1; else return 0; }

int ACE::process_active (  pid_t    pid )  [static]

Checks if process with <pid> is still alive. Returns 1 if it is still alive, 0 if it isn't alive, and -1 if something weird happened. Definition at line 221 of file ACE.cpp. References ACE_OS::kill, and pid_t. { #if !defined(ACE_WIN32) int retval = ACE_OS::kill (pid, 0); if (retval == 0) return 1; else if (errno == ESRCH) return 0; else return -1; #else // Create a handle for the given process id. ACE_HANDLE process_handle = ::OpenProcess (PROCESS_QUERY_INFORMATION, FALSE, pid); if (process_handle == ACE_INVALID_HANDLE || process_handle == 0) return 0; else { DWORD status; int result = 1; if (::GetExitCodeProcess (process_handle, &status) == 0 || status != STILL_ACTIVE) result = 0; ::CloseHandle (process_handle); return result; } #endif /* !ACE_WIN32 */ }

ASYS_INLINE ssize_t ACE::read_n (  ACE_HANDLE    handle, void *    buf, size_t    len, size_t *    bytes_transferred = 0 )  [static]

Definition at line 7 of file ACE.i. References ACE_OS::read_n. Referenced by ACE_SPIPE_Stream::recv_n, ACE_FILE_IO::recv_n, and ACE_DEV_IO::recv_n. { return ACE_OS::read_n (handle, buf, len, bytes_transferred); }

ssize_t ACE::readv_n (  ACE_HANDLE    handle, iovec *    iov, int    iovcnt, size_t *    bytes_transferred = 0 )  [static]

Definition at line 2306 of file ACE.cpp. References iovec::iov_base, iovec::iov_len, ACE_OS::readv, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; bytes_transferred = 0; for (int s = 0; s < iovcnt; ) { ssize_t n = ACE_OS::readv (handle, iov + s, iovcnt - s); if (n == -1 || n == 0) return n; for (bytes_transferred += n; s < iovcnt && n >= ACE_static_cast (ssize_t, iov[s].iov_len); s++) n -= iov[s].iov_len; if (n != 0) { char *base = ACE_reinterpret_cast (char *, iov[s].iov_base); iov[s].iov_base = base + n; iov[s].iov_len = iov[s].iov_len - n; } } return bytes_transferred; }

void ACE::record_and_set_non_blocking_mode (  ACE_HANDLE    handle, int &    val )  [static]

This makes sure that <handle> is set into non-blocking mode. <val> keeps track of whether were in non-blocking mode or not. Definition at line 2475 of file ACE.cpp. References ACE_BIT_DISABLED, ACE_NONBLOCK, ACE_Flag_Manip::get_flags, and ACE_Flag_Manip::set_flags. Referenced by enter_recv_timedwait, enter_send_timedwait, recv_n_i, recvv_n_i, send_n_i, sendv_n_i, t_rcv_n_i, and t_snd_n_i. { // We need to record whether we are already *in* nonblocking mode, // so that we can correctly reset the state when we're done. val = ACE::get_flags (handle); if (ACE_BIT_DISABLED (val, ACE_NONBLOCK)) // Set the handle into non-blocking mode if it's not already in // it. ACE::set_flags (handle, ACE_NONBLOCK); }

ssize_t ACE::recv (  ACE_HANDLE    handle, size_t    n, ...    )  [static]

Receive into a variable number of pieces. Accepts a variable, caller-specified, number of pointer/length pairs. Arguments following n are char *, size_t pairs. Parameters: handle  The I/O handle to receive on n  The total number of char *, size_t pairs following n. Returns: -1 on error, else total number of bytes received. Definition at line 1093 of file ACE.cpp. References ACE_NEW_RETURN, iovec::iov_base, iovec::iov_len, ACE_OS::recvv, and ssize_t. { va_list argp; int total_tuples = ACE_static_cast (int, (n / 2)); iovec *iovp; #if defined (ACE_HAS_ALLOCA) iovp = (iovec *) alloca (total_tuples * sizeof (iovec)); #else ACE_NEW_RETURN (iovp, iovec[total_tuples], -1); #endif /* !defined (ACE_HAS_ALLOCA) */ va_start (argp, n); for (int i = 0; i < total_tuples; i++) { iovp[i].iov_base = va_arg (argp, char *); iovp[i].iov_len = va_arg (argp, int); } ssize_t result = ACE_OS::recvv (handle, iovp, total_tuples); #if !defined (ACE_HAS_ALLOCA) delete [] iovp; #endif /* !defined (ACE_HAS_ALLOCA) */ va_end (argp); return result; }

ssize_t ACE::recv (  ACE_HANDLE    handle, void *    buf, size_t    len, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 642 of file ACE.cpp. References enter_recv_timedwait, ACE_OS::gettimeofday, recv_i, restore_non_blocking_mode, and ssize_t. { if (timeout == 0) return ACE::recv_i (handle, buf, n); else { #if defined (ACE_HAS_READ_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday (); timespec_t ts = copy; return ::read_timedwait (handle, buf, n, &ts); #else int val = 0; if (ACE::enter_recv_timedwait (handle, timeout, val) == -1) return -1; else { ssize_t bytes_transferred = ACE::recv_i (handle, buf, n); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_READ_TIMEDWAIT */ } }

ssize_t ACE::recv (  ACE_HANDLE    handle, void *    buf, size_t    len, int    flags, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 585 of file ACE.cpp. References enter_recv_timedwait, ACE_OS::gettimeofday, ACE_OS::recv, restore_non_blocking_mode, and ssize_t. Referenced by ACE_MEM_Acceptor::accept, ACE_MEM_Connector::connect, handle_timed_complete, ACE_Select_Reactor_Notify::read_notify_pipe, ACE_Dev_Poll_Reactor_Notify::read_notify_pipe, ACE_TLI_Stream::recv, ACE_SOCK_IO::recv, ACE_Reactive_MEM_IO::recv_buf, and ACE_SOCK_Stream::recv_urg. { if (timeout == 0) return ACE_OS::recv (handle, (char *) buf, len, flags); else { #if defined (ACE_HAS_RECV_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday (); timespec_t ts = copy; return ::recv_timedwait (handle, buf, len, flags, &ts); #else int val = 0; if (ACE::enter_recv_timedwait (handle, timeout, val) ==-1) return -1; else { ssize_t bytes_transferred = ACE_OS::recv (handle, (char *) buf, len, flags); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_RECV_TIMEDWAIT */ } }

ASYS_INLINE ssize_t ACE::recv_i (  ACE_HANDLE    handle, void *    buf, size_t    len )  [static, private]

Definition at line 221 of file ACE.i. References ACE_OS::read, and ACE_OS::recv. Referenced by recv, and recv_n_i. { #if defined (ACE_WIN32) || defined (ACE_PSOS) return ACE_OS::recv (handle, (char *) buf, len); #else return ACE_OS::read (handle, (char *) buf, len); #endif /* ACE_WIN32 */ }

ssize_t ACE::recv_n (  ACE_HANDLE    handle, ACE_Message_Block *    message_block, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Definition at line 1296 of file ACE.cpp. References ACE_IOV_MAX, ACE_Message_Block::cont, iovec::iov_base, iovec::iov_len, ACE_Message_Block::length, ACE_Message_Block::next, ACE_Message_Block::rd_ptr, recvv_n, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; bytes_transferred = 0; iovec iov[ACE_IOV_MAX]; int iovcnt = 0; while (message_block != 0) { // Our current message block chain. const ACE_Message_Block *current_message_block = message_block; while (current_message_block != 0) { size_t current_message_block_length = current_message_block->length (); char *this_rd_ptr = current_message_block->rd_ptr (); // Check if this block has any space for incoming data. while (current_message_block_length > 0) { u_long this_chunk_length; if (current_message_block_length > ULONG_MAX) this_chunk_length = ULONG_MAX; else this_chunk_length = ACE_static_cast (u_long, current_message_block_length); // Collect the data in the iovec. iov[iovcnt].iov_base = this_rd_ptr; iov[iovcnt].iov_len = this_chunk_length; current_message_block_length -= this_chunk_length; this_rd_ptr += this_chunk_length; // Increment iovec counter. iovcnt++; // The buffer is full make a OS call. @@ TODO find a way to // find ACE_IOV_MAX for platforms that do not define it rather // than simply setting ACE_IOV_MAX to some arbitrary value such // as 16. if (iovcnt == ACE_IOV_MAX) { size_t current_transfer = 0; ssize_t result = ACE::recvv_n (handle, iov, iovcnt, timeout, &current_transfer); // Add to total bytes transferred. bytes_transferred += current_transfer; // Errors. if (result == -1 || result == 0) return result; // Reset iovec counter. iovcnt = 0; } } // Select the next message block in the chain. current_message_block = current_message_block->cont (); } // Selection of the next message block chain. message_block = message_block->next (); } // Check for remaining buffers to be sent. This will happen when // ACE_IOV_MAX is not a multiple of the number of message blocks. if (iovcnt != 0) { size_t current_transfer = 0; ssize_t result = ACE::recvv_n (handle, iov, iovcnt, timeout, &current_transfer); // Add to total bytes transferred. bytes_transferred += current_transfer; // Errors. if (result == -1 || result == 0) return result; } // Return total bytes transferred. return bytes_transferred; }

ASYS_INLINE ssize_t ACE::recv_n (  ACE_HANDLE    handle, void *    buf, size_t    len, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Definition at line 81 of file ACE.i. References recv_n_i. { if (timeout == 0) return ACE::recv_n_i (handle, buf, len, bytes_transferred); else return ACE::recv_n_i (handle, buf, len, timeout, bytes_transferred); }

ASYS_INLINE ssize_t ACE::recv_n (  ACE_HANDLE    handle, void *    buf, size_t    len, int    flags, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Definition at line 31 of file ACE.i. References recv_n_i. Referenced by ACE_TLI_Stream::recv_n, ACE_SOCK_Stream::recv_n, and ACE_FIFO_Recv::recv_n. { if (timeout == 0) return ACE::recv_n_i (handle, buf, len, flags, bytes_transferred); else return ACE::recv_n_i (handle, buf, len, flags, timeout, bytes_transferred); }

ssize_t ACE::recv_n_i (  ACE_HANDLE    handle, void *    buf, size_t    len, const ACE_Time_Value *    timeout, size_t *    bytes_transferred )  [static, private]

Definition at line 1022 of file ACE.cpp. References EWOULDBLOCK, handle_read_ready, record_and_set_non_blocking_mode, recv_i, restore_non_blocking_mode, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; ssize_t result = 0; int error = 0; int val = 0; ACE::record_and_set_non_blocking_mode (handle, val); for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. // Since the socket is in non-blocking mode, this call will not // block. n = ACE::recv_i (handle, (char *) buf + bytes_transferred, len - bytes_transferred); // Check for errors. if (n == 0 || n == -1) { // Check for possible blocking. if (n == -1 && errno == EWOULDBLOCK) { // Wait upto <timeout> for the blocking to subside. int rtn = ACE::handle_read_ready (handle, timeout); // Did select() succeed? if (rtn != -1) { // Blocking subsided in <timeout> period. Continue // data transfer. n = 0; continue; } } // Wait in select() timed out or other data transfer or // select() failures. error = 1; result = n; break; } } ACE::restore_non_blocking_mode (handle, val); if (error) return result; else return ACE_static_cast (ssize_t, bytes_transferred); }

ssize_t ACE::recv_n_i (  ACE_HANDLE    handle, void *    buf, size_t    len, size_t *    bytes_transferred )  [static, private]

Definition at line 972 of file ACE.cpp. References EWOULDBLOCK, handle_read_ready, recv_i, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. n = ACE::recv_i (handle, (char *) buf + bytes_transferred, len - bytes_transferred); // Check EOF. if (n == 0) { return 0; } // Check for other errors. if (n == -1) { // Check for possible blocking. if (errno == EWOULDBLOCK) { // Wait for the blocking to subside. int result = ACE::handle_read_ready (handle, 0); // Did select() succeed? if (result != -1) { // Blocking subsided. Continue data transfer. n = 0; continue; } } // Other data transfer or select() failures. return -1; } } return ACE_static_cast (ssize_t, bytes_transferred); }

ssize_t ACE::recv_n_i (  ACE_HANDLE    handle, void *    buf, size_t    len, int    flags, const ACE_Time_Value *    timeout, size_t *    bytes_transferred )  [static, private]

Definition at line 783 of file ACE.cpp. References EWOULDBLOCK, handle_read_ready, record_and_set_non_blocking_mode, ACE_OS::recv, restore_non_blocking_mode, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; ssize_t result = 0; int error = 0; int val = 0; ACE::record_and_set_non_blocking_mode (handle, val); for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. // Since the socket is in non-blocking mode, this call will not // block. n = ACE_OS::recv (handle, (char *) buf + bytes_transferred, len - bytes_transferred, flags); // Check for errors. if (n == 0 || n == -1) { // Check for possible blocking. if (n == -1 && errno == EWOULDBLOCK) { // Wait upto <timeout> for the blocking to subside. int rtn = ACE::handle_read_ready (handle, timeout); // Did select() succeed? if (rtn != -1) { // Blocking subsided in <timeout> period. Continue // data transfer. n = 0; continue; } } // Wait in select() timed out or other data transfer or // select() failures. error = 1; result = n; break; } } ACE::restore_non_blocking_mode (handle, val); if (error) return result; else return ACE_static_cast (ssize_t, bytes_transferred); }

ssize_t ACE::recv_n_i (  ACE_HANDLE    handle, void *    buf, size_t    len, int    flags, size_t *    bytes_transferred )  [static, private]

Definition at line 732 of file ACE.cpp. References EWOULDBLOCK, handle_read_ready, ACE_OS::recv, and ssize_t. Referenced by recv_n. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. n = ACE_OS::recv (handle, (char *) buf + bytes_transferred, len - bytes_transferred, flags); // Check EOF. if (n == 0) return 0; // Check for other errors. if (n == -1) { // Check for possible blocking. if (errno == EWOULDBLOCK) { // Wait for the blocking to subside. int result = ACE::handle_read_ready (handle, 0); // Did select() succeed? if (result != -1) { // Blocking subsided. Continue data transfer. n = 0; continue; } } // Other data transfer or select() failures. return -1; } } return ACE_static_cast (ssize_t, bytes_transferred); }

ssize_t ACE::recvfrom (  ACE_HANDLE    handle, char *    buf, int    len, int    flags, struct sockaddr *    addr, int *    addrlen, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 700 of file ACE.cpp. References enter_recv_timedwait, ACE_OS::gettimeofday, ACE_OS::recvfrom, and restore_non_blocking_mode. { if (timeout == 0) return ACE_OS::recvfrom (handle, buf, len, flags, addr, addrlen); else { #if defined (ACE_HAS_RECVFROM_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday (); timespec_t ts = copy; return ::recvfrom_timedwait (handle, buf, len, flags, addr, addrlen, &ts); #else int val = 0; if (ACE::enter_recv_timedwait (handle, timeout, val) == -1) return -1; else { int bytes_transferred = ACE_OS::recvfrom (handle, buf, len, flags, addr, addrlen); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_RECVFROM_TIMEDWAIT */ } }

ssize_t ACE::recvmsg (  ACE_HANDLE    handle, struct msghdr *    msg, int    flags, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 671 of file ACE.cpp. References enter_recv_timedwait, ACE_OS::gettimeofday, ACE_OS::recvmsg, and restore_non_blocking_mode. { if (timeout == 0) return ACE_OS::recvmsg (handle, msg, flags); else { #if defined (ACE_HAS_RECVMSG_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday (); timespec_t ts = copy; return ::recvmsg_timedwait (handle, msg, flags, &ts); #else int val = 0; if (ACE::enter_recv_timedwait (handle, timeout, val) == -1) return -1; else { int bytes_transferred = ACE_OS::recvmsg (handle, msg, flags); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_RECVMSG_TIMEDWAIT */ } }

ssize_t ACE::recvv (  ACE_HANDLE    handle, iovec *    iov, int    iovcnt, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 1123 of file ACE.cpp. References enter_recv_timedwait, ACE_OS::gettimeofday, ACE_OS::recvv, restore_non_blocking_mode, and ssize_t. Referenced by ACE_SOCK_IO::recvv. { if (timeout == 0) return ACE_OS::recvv (handle, iov, iovcnt); else { #if defined (ACE_HAS_READV_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday (); timespec_t ts = copy; return ::readv_timedwait (handle, iov, iovcnt, &ts); #else int val = 0; if (ACE::enter_recv_timedwait (handle, timeout, val) == -1) return -1; else { ssize_t bytes_transferred = ACE_OS::recvv (handle, iov, iovcnt); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_READV_TIMEDWAIT */ } }

ASYS_INLINE ssize_t ACE::recvv_n (  ACE_HANDLE    handle, iovec *    iov, int    iovcnt, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Definition at line 101 of file ACE.i. References recvv_n_i. Referenced by recv_n, and ACE_SOCK_Stream::recvv_n. { if (timeout == 0) return ACE::recvv_n_i (handle, iov, iovcnt, bytes_transferred); else return ACE::recvv_n_i (handle, iov, iovcnt, timeout, bytes_transferred); }

ssize_t ACE::recvv_n_i (  ACE_HANDLE    handle, iovec *    iov, int    iovcnt, const ACE_Time_Value *    timeout, size_t *    bytes_transferred )  [static, private]

Definition at line 1216 of file ACE.cpp. References EWOULDBLOCK, handle_read_ready, iovec::iov_base, iovec::iov_len, record_and_set_non_blocking_mode, ACE_OS::recvv, restore_non_blocking_mode, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; bytes_transferred = 0; ssize_t result = 0; int error = 0; int val = 0; ACE::record_and_set_non_blocking_mode (handle, val); for (int s = 0; s < iovcnt; ) { // Try to transfer as much of the remaining data as possible. // Since the socket is in non-blocking mode, this call will not // block. ssize_t n = ACE_OS::recvv (handle, iov + s, iovcnt - s); // Check for errors. if (n == 0 || n == -1) { // Check for possible blocking. if (n == -1 && errno == EWOULDBLOCK) { // Wait upto <timeout> for the blocking to subside. int rtn = ACE::handle_read_ready (handle, timeout); // Did select() succeed? if (rtn != -1) { // Blocking subsided in <timeout> period. Continue // data transfer. n = 0; continue; } } // Wait in select() timed out or other data transfer or // select() failures. error = 1; result = n; break; } for (bytes_transferred += n; s < iovcnt && n >= ACE_static_cast (ssize_t, iov[s].iov_len); s++) n -= iov[s].iov_len; if (n != 0) { char *base = ACE_reinterpret_cast (char *, iov[s].iov_base); iov[s].iov_base = base + n; iov[s].iov_len = iov[s].iov_len - n; } } ACE::restore_non_blocking_mode (handle, val); if (error) return result; else return bytes_transferred; }

ssize_t ACE::recvv_n_i (  ACE_HANDLE    handle, iovec *    iov, int    iovcnt, size_t *    bytes_transferred )  [static, private]

Definition at line 1152 of file ACE.cpp. References EWOULDBLOCK, handle_read_ready, iovec::iov_base, iovec::iov_len, ACE_OS::recvv, and ssize_t. Referenced by recvv_n. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; bytes_transferred = 0; for (int s = 0; s < iovcnt; ) { // Try to transfer as much of the remaining data as possible. ssize_t n = ACE_OS::recvv (handle, iov + s, iovcnt - s); // Check EOF. if (n == 0) return 0; // Check for other errors. if (n == -1) { // Check for possible blocking. if (errno == EWOULDBLOCK) { // Wait for the blocking to subside. int result = ACE::handle_read_ready (handle, 0); // Did select() succeed? if (result != -1) { // Blocking subsided. Continue data transfer. n = 0; continue; } } // Other data transfer or select() failures. return -1; } for (bytes_transferred += n; s < iovcnt && n >= ACE_static_cast (ssize_t, iov[s].iov_len); s++) n -= iov[s].iov_len; if (n != 0) { char *base = ACE_static_cast (char *, iov[s].iov_base); iov[s].iov_base = base + n; iov[s].iov_len = iov[s].iov_len - n; } } return bytes_transferred; }

void ACE::restore_non_blocking_mode (  ACE_HANDLE    handle, int    val )  [static]

Cleanup after a timed operation, restore the appropriate non-blocking status of <handle>. Definition at line 2489 of file ACE.cpp. References ACE_BIT_DISABLED, ACE_NONBLOCK, and ACE_Flag_Manip::clr_flags. Referenced by recv, recv_n_i, recvfrom, recvmsg, recvv, recvv_n_i, send, send_n_i, sendmsg, sendto, sendv, sendv_n_i, t_rcv, t_rcv_n_i, t_snd, and t_snd_n_i. { if (ACE_BIT_DISABLED (val, ACE_NONBLOCK)) { // Save/restore errno. ACE_Errno_Guard error (errno); // Only disable ACE_NONBLOCK if we weren't in non-blocking mode // originally. ACE::clr_flags (handle, ACE_NONBLOCK); } }

size_t ACE::round_to_allocation_granularity (  off_t    len )  [static]

Rounds the request to a multiple of the allocation granularity. Definition at line 2703 of file ACE.cpp. References ACE_TRACE, ACE_OS::allocation_granularity, and allocation_granularity_. { ACE_TRACE ("ACE::round_to_allocation_granularity"); if (ACE::allocation_granularity_ == 0) ACE::allocation_granularity_ = ACE_OS::allocation_granularity (); return (len + (ACE::allocation_granularity_ - 1)) & ~(ACE::allocation_granularity_ - 1); }

size_t ACE::round_to_pagesize (  off_t    length )  [static]

Rounds the request to a multiple of the page size. Definition at line 2692 of file ACE.cpp. References ACE_TRACE, ACE_OS::getpagesize, and pagesize_. Referenced by ACE_Shared_Memory_Pool::init_acquire, ACE_Sbrk_Memory_Pool::round_up, ACE_Shared_Memory_Pool::round_up, ACE_Local_Memory_Pool::round_up, and ACE_MMAP_Memory_Pool::round_up. { ACE_TRACE ("ACE::round_to_pagesize"); if (ACE::pagesize_ == 0) ACE::pagesize_ = ACE_OS::getpagesize (); return (len + (ACE::pagesize_ - 1)) & ~(ACE::pagesize_ - 1); }

int ACE::select (  int    width, ACE_Handle_Set &    readfds, const ACE_Time_Value *    timeout = 0 )  [static]

Wrapper facade for the most common use of <select> that uses <ACE_Handle_Set>s. Definition at line 161 of file ACE.cpp. References ACE_Handle_Set::fdset, ACE_OS::select, and ACE_Handle_Set::sync. { int result = ACE_OS::select (width, readfds.fdset (), 0, 0, timeout); #if !defined (ACE_WIN64) if (result > 0) readfds.sync ((ACE_HANDLE) width); #endif /* ACE_WIN64 */ return result; }

int ACE::select (  int    width, ACE_Handle_Set *    readfds, ACE_Handle_Set *    writefds = 0, ACE_Handle_Set *    exceptfds = 0, const ACE_Time_Value *    timeout = 0 )  [static]

Wrapper facade for <select> that uses <ACE_Handle_Set>s. Definition at line 134 of file ACE.cpp. References ACE_Handle_Set::fdset, ACE_OS::select, and ACE_Handle_Set::sync. { int result = ACE_OS::select (width, readfds ? readfds->fdset () : 0, writefds ? writefds->fdset () : 0, exceptfds ? exceptfds->fdset () : 0, timeout); if (result > 0) { # if !defined (ACE_WIN64) // This isn't needed for Windows... it's a no-op anyway. if (readfds) readfds->sync ((ACE_HANDLE) width); if (writefds) writefds->sync ((ACE_HANDLE) width); if (exceptfds) exceptfds->sync ((ACE_HANDLE) width); #endif /* ACE_WIN64 */ } return result; }

ssize_t ACE::send (  ACE_HANDLE    handle, size_t    n, ...    )  [static]

Varargs variant. Definition at line 1902 of file ACE.cpp. References ACE_NEW_RETURN, iovec::iov_base, iovec::iov_len, ACE_OS::sendv, and ssize_t. { va_list argp; int total_tuples = ACE_static_cast (int, (n / 2)); iovec *iovp; #if defined (ACE_HAS_ALLOCA) iovp = (iovec *) alloca (total_tuples * sizeof (iovec)); #else ACE_NEW_RETURN (iovp, iovec[total_tuples], -1); #endif /* !defined (ACE_HAS_ALLOCA) */ va_start (argp, n); for (int i = 0; i < total_tuples; i++) { iovp[i].iov_base = va_arg (argp, char *); iovp[i].iov_len = va_arg (argp, int); } ssize_t result = ACE_OS::sendv (handle, iovp, total_tuples); #if !defined (ACE_HAS_ALLOCA) delete [] iovp; #endif /* !defined (ACE_HAS_ALLOCA) */ va_end (argp); return result; }

ssize_t ACE::send (  ACE_HANDLE    handle, const void *    buf, size_t    len, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 1453 of file ACE.cpp. References enter_send_timedwait, ACE_OS::gettimeofday, restore_non_blocking_mode, send_i, and ssize_t. { if (timeout == 0) return ACE::send_i (handle, buf, n); else { #if defined (ACE_HAS_WRITE_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday (); timespec_t ts = copy; return ::write_timedwait (handle, buf, n, &ts); #else int val = 0; if (ACE::enter_send_timedwait (handle, timeout, val) == -1) return -1; else { ssize_t bytes_transferred = ACE::send_i (handle, buf, n); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_WRITE_TIMEDWAIT */ } }

ssize_t ACE::send (  ACE_HANDLE    handle, const void *    buf, size_t    len, int    flags, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 1396 of file ACE.cpp. References enter_send_timedwait, ACE_OS::gettimeofday, restore_non_blocking_mode, ACE_OS::send, and ssize_t. Referenced by ACE_MEM_Acceptor::accept, ACE_MEM_Connector::connect, ACE_Select_Reactor_Notify::notify, ACE_AIOCB_Notify_Pipe_Manager::notify, ACE_Dev_Poll_Reactor_Notify::notify, ACE_TLI_Stream::send, ACE_SOCK_IO::send, ACE_Reactive_MEM_IO::send_buf, and ACE_SOCK_Stream::send_urg. { if (timeout == 0) return ACE_OS::send (handle, (const char *) buf, n, flags); else { #if defined (ACE_HAS_SEND_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday(); timespec_t ts = copy; return ::send_timedwait (handle, buf, n, flags, &ts); #else int val = 0; if (ACE::enter_send_timedwait (handle, timeout, val) == -1) return -1; else { ssize_t bytes_transferred = ACE_OS::send (handle, (const char *) buf, n, flags); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_SEND_TIMEDWAIT */ } }

ASYS_INLINE ssize_t ACE::send_i (  ACE_HANDLE    handle, const void *    buf, size_t    len )  [static, private]

Definition at line 211 of file ACE.i. References ACE_OS::send, and ACE_OS::write. Referenced by send, and send_n_i. { #if defined (ACE_WIN32) || defined (ACE_PSOS) || defined (HPUX) return ACE_OS::send (handle, (const char *) buf, len); #else return ACE_OS::write (handle, (const char *) buf, len); #endif /* ACE_WIN32 */ }

ssize_t ACE::send_n (  ACE_HANDLE    handle, const ACE_Message_Block *    message_block, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Send all the <message_block>s chained through their <next> and <cont> pointers. This call uses the underlying OS gather-write operation to reduce the domain-crossing penalty. Definition at line 2206 of file ACE.cpp. References ACE_IOV_MAX, ACE_Message_Block::cont, iovec::iov_base, iovec::iov_len, ACE_Message_Block::length, ACE_Message_Block::next, ACE_Message_Block::rd_ptr, sendv_n, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; bytes_transferred = 0; iovec iov[ACE_IOV_MAX]; int iovcnt = 0; while (message_block != 0) { // Our current message block chain. const ACE_Message_Block *current_message_block = message_block; while (current_message_block != 0) { char *this_block_ptr = current_message_block->rd_ptr (); size_t current_message_block_length = current_message_block->length (); // Check if this block has any data to be sent. while (current_message_block_length > 0) { u_long this_chunk_length; if (current_message_block_length > ULONG_MAX) this_chunk_length = ULONG_MAX; else this_chunk_length = ACE_static_cast (u_long, current_message_block_length); // Collect the data in the iovec. iov[iovcnt].iov_base = this_block_ptr; iov[iovcnt].iov_len = this_chunk_length; current_message_block_length -= this_chunk_length; this_block_ptr += this_chunk_length; // Increment iovec counter. iovcnt++; // The buffer is full make a OS call. @@ TODO find a way to // find ACE_IOV_MAX for platforms that do not define it rather // than simply setting ACE_IOV_MAX to some arbitrary value such // as 16. if (iovcnt == ACE_IOV_MAX) { size_t current_transfer = 0; ssize_t result = ACE::sendv_n (handle, iov, iovcnt, timeout, &current_transfer); // Add to total bytes transferred. bytes_transferred += current_transfer; // Errors. if (result == -1 || result == 0) return result; // Reset iovec counter. iovcnt = 0; } } // Select the next message block in the chain. current_message_block = current_message_block->cont (); } // Selection of the next message block chain. message_block = message_block->next (); } // Check for remaining buffers to be sent. This will happen when // ACE_IOV_MAX is not a multiple of the number of message blocks. if (iovcnt != 0) { size_t current_transfer = 0; ssize_t result = ACE::sendv_n (handle, iov, iovcnt, timeout, &current_transfer); // Add to total bytes transferred. bytes_transferred += current_transfer; // Errors. if (result == -1 || result == 0) return result; } // Return total bytes transferred. return bytes_transferred; }

ASYS_INLINE ssize_t ACE::send_n (  ACE_HANDLE    handle, const void *    buf, size_t    len, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Definition at line 171 of file ACE.i. References send_n_i. { if (timeout == 0) return ACE::send_n_i (handle, buf, len, bytes_transferred); else return ACE::send_n_i (handle, buf, len, timeout, bytes_transferred); }

ASYS_INLINE ssize_t ACE::send_n (  ACE_HANDLE    handle, const void *    buf, size_t    len, int    flags, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Definition at line 121 of file ACE.i. References send_n_i. Referenced by ACE_TLI_Stream::send_n, ACE_SOCK_Stream::send_n, and ACE_FIFO_Send::send_n. { if (timeout == 0) return ACE::send_n_i (handle, buf, len, flags, bytes_transferred); else return ACE::send_n_i (handle, buf, len, flags, timeout, bytes_transferred); }

ssize_t ACE::send_n_i (  ACE_HANDLE    handle, const void *    buf, size_t    len, const ACE_Time_Value *    timeout, size_t *    bytes_transferred )  [static, private]

Definition at line 1832 of file ACE.cpp. References ENOBUFS, EWOULDBLOCK, handle_write_ready, record_and_set_non_blocking_mode, restore_non_blocking_mode, send_i, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; ssize_t result = 0; int error = 0; int val = 0; ACE::record_and_set_non_blocking_mode (handle, val); for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. // Since the socket is in non-blocking mode, this call will not // block. n = ACE::send_i (handle, (char *) buf + bytes_transferred, len - bytes_transferred); // Check for errors. if (n == 0 || n == -1) { // Check for possible blocking. if (n == -1 && errno == EWOULDBLOCK || errno == ENOBUFS) { // Wait upto <timeout> for the blocking to subside. int rtn = ACE::handle_write_ready (handle, timeout); // Did select() succeed? if (rtn != -1) { // Blocking subsided in <timeout> period. Continue // data transfer. n = 0; continue; } } // Wait in select() timed out or other data transfer or // select() failures. error = 1; result = n; break; } } ACE::restore_non_blocking_mode (handle, val); if (error) return result; else return bytes_transferred; }

ssize_t ACE::send_n_i (  ACE_HANDLE    handle, const void *    buf, size_t    len, size_t *    bytes_transferred )  [static, private]

Definition at line 1783 of file ACE.cpp. References ENOBUFS, EWOULDBLOCK, handle_write_ready, send_i, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. n = ACE::send_i (handle, (char *) buf + bytes_transferred, len - bytes_transferred); // Check EOF. if (n == 0) return 0; // Check for other errors. if (n == -1) { // Check for possible blocking. if (errno == EWOULDBLOCK || errno == ENOBUFS) { // Wait for the blocking to subside. int result = ACE::handle_write_ready (handle, 0); // Did select() succeed? if (result != -1) { // Blocking subsided. Continue data transfer. n = 0; continue; } } // Other data transfer or select() failures. return -1; } } return bytes_transferred; }

ssize_t ACE::send_n_i (  ACE_HANDLE    handle, const void *    buf, size_t    len, int    flags, const ACE_Time_Value *    timeout, size_t *    bytes_transferred )  [static, private]

Definition at line 1594 of file ACE.cpp. References ENOBUFS, EWOULDBLOCK, handle_write_ready, record_and_set_non_blocking_mode, restore_non_blocking_mode, ACE_OS::send, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; ssize_t result = 0; int error = 0; int val = 0; ACE::record_and_set_non_blocking_mode (handle, val); for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. // Since the socket is in non-blocking mode, this call will not // block. n = ACE_OS::send (handle, (char *) buf + bytes_transferred, len - bytes_transferred, flags); // Check for errors. if (n == 0 || n == -1) { // Check for possible blocking. if (n == -1 && errno == EWOULDBLOCK || errno == ENOBUFS) { // Wait upto <timeout> for the blocking to subside. int rtn = ACE::handle_write_ready (handle, timeout); // Did select() succeed? if (rtn != -1) { // Blocking subsided in <timeout> period. Continue // data transfer. n = 0; continue; } } // Wait in select() timed out or other data transfer or // select() failures. error = 1; result = n; break; } } ACE::restore_non_blocking_mode (handle, val); if (error) return result; else return bytes_transferred; }

ssize_t ACE::send_n_i (  ACE_HANDLE    handle, const void *    buf, size_t    len, int    flags, size_t *    bytes_transferred )  [static, private]

Definition at line 1543 of file ACE.cpp. References ENOBUFS, EWOULDBLOCK, handle_write_ready, ACE_OS::send, and ssize_t. Referenced by send_n. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. n = ACE_OS::send (handle, (char *) buf + bytes_transferred, len - bytes_transferred, flags); // Check EOF. if (n == 0) return 0; // Check for other errors. if (n == -1) { // Check for possible blocking. if (errno == EWOULDBLOCK || errno == ENOBUFS) { // Wait for the blocking to subside. int result = ACE::handle_write_ready (handle, 0); // Did select() succeed? if (result != -1) { // Blocking subsided. Continue data transfer. n = 0; continue; } } // Other data transfer or select() failures. return -1; } } return bytes_transferred; }

ssize_t ACE::sendmsg (  ACE_HANDLE    handle, const struct msghdr *    msg, int    flags, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 1482 of file ACE.cpp. References enter_send_timedwait, ACE_OS::gettimeofday, restore_non_blocking_mode, and ACE_OS::sendmsg. { if (timeout == 0) return ACE_OS::sendmsg (handle, msg, flags); else { #if defined (ACE_HAS_SENDMSG_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday (); timespec_t ts = copy; return ::sendmsg_timedwait (handle, msg, flags, &ts); #else int val = 0; if (ACE::enter_send_timedwait (handle, timeout, val) == -1) return -1; else { int bytes_transferred = ACE_OS::sendmsg (handle, msg, flags); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_SENDMSG_TIMEDWAIT */ } }

ssize_t ACE::sendto (  ACE_HANDLE    handle, const char *    buf, int    len, int    flags, const struct sockaddr *    addr, int    addrlen, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 1511 of file ACE.cpp. References enter_send_timedwait, ACE_OS::gettimeofday, restore_non_blocking_mode, and ACE_OS::sendto. { if (timeout == 0) return ACE_OS::sendto (handle, buf, len, flags, addr, addrlen); else { #if defined (ACE_HAS_SENDTO_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday (); timespec_t ts = copy; return ::sendto_timedwait (handle, buf, len, flags, addr, addrlen, ts); #else int val = 0; if (ACE::enter_send_timedwait (handle, timeout, val) == -1) return -1; else { int bytes_transferred = ACE_OS::sendto (handle, buf, len, flags, addr, addrlen); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_SENDTO_TIMEDWAIT */ } }

ssize_t ACE::sendv (  ACE_HANDLE    handle, const iovec *    iov, int    iovcnt, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 1932 of file ACE.cpp. References enter_send_timedwait, ACE_OS::gettimeofday, restore_non_blocking_mode, ACE_OS::sendv, and ssize_t. Referenced by ACE_SOCK_IO::sendv. { if (timeout == 0) return ACE_OS::sendv (handle, iov, iovcnt); else { #if defined (ACE_HAS_WRITEV_TIMEDWAIT) ACE_Time_Value copy = *timeout; copy += ACE_OS::gettimeofday (); timespec_t ts = copy; return ::sendv_timedwait (handle, iov, iovcnt, &ts); #else int val = 0; if (ACE::enter_send_timedwait (handle, timeout, val) == -1) return -1; else { ssize_t bytes_transferred = ACE_OS::sendv (handle, iov, iovcnt); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } #endif /* ACE_HAS_WRITEV_TIMEDWAIT */ } }

ASYS_INLINE ssize_t ACE::sendv_n (  ACE_HANDLE    handle, const iovec *    iov, int    iovcnt, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Definition at line 191 of file ACE.i. References sendv_n_i. Referenced by send_n, and ACE_SOCK_Stream::sendv_n. { if (timeout == 0) return ACE::sendv_n_i (handle, iov, iovcnt, bytes_transferred); else return ACE::sendv_n_i (handle, iov, iovcnt, timeout, bytes_transferred); }

ssize_t ACE::sendv_n_i (  ACE_HANDLE    handle, const iovec *    iov, int    iovcnt, const ACE_Time_Value *    timeout, size_t *    bytes_transferred )  [static, private]

Definition at line 2027 of file ACE.cpp. References ENOBUFS, EWOULDBLOCK, handle_write_ready, iovec::iov_base, iovec::iov_len, record_and_set_non_blocking_mode, restore_non_blocking_mode, ACE_OS::sendv, and ssize_t. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; bytes_transferred = 0; ssize_t result = 0; int error = 0; int val = 0; ACE::record_and_set_non_blocking_mode (handle, val); iovec *iov = ACE_const_cast (iovec *, i); for (int s = 0; s < iovcnt; ) { // Try to transfer as much of the remaining data as possible. // Since the socket is in non-blocking mode, this call will not // block. ssize_t n = ACE_OS::sendv (handle, iov + s, iovcnt - s); // Check for errors. if (n == 0 || n == -1) { // Check for possible blocking. if (n == -1 && errno == EWOULDBLOCK || errno == ENOBUFS) { // Wait upto <timeout> for the blocking to subside. int rtn = ACE::handle_write_ready (handle, timeout); // Did select() succeed? if (rtn != -1) { // Blocking subsided in <timeout> period. Continue // data transfer. n = 0; continue; } } // Wait in select() timed out or other data transfer or // select() failures. error = 1; result = n; break; } for (bytes_transferred += n; s < iovcnt && n >= ACE_static_cast (ssize_t, iov[s].iov_len); s++) n -= iov[s].iov_len; if (n != 0) { char *base = ACE_reinterpret_cast (char *, iov[s].iov_base); iov[s].iov_base = base + n; iov[s].iov_len = iov[s].iov_len - n; } } ACE::restore_non_blocking_mode (handle, val); if (error) return result; else return bytes_transferred; }

ssize_t ACE::sendv_n_i (  ACE_HANDLE    handle, const iovec *    iov, int    iovcnt, size_t *    bytes_transferred )  [static, private]

Definition at line 1961 of file ACE.cpp. References ENOBUFS, EWOULDBLOCK, handle_write_ready, iovec::iov_base, iovec::iov_len, ACE_OS::sendv, and ssize_t. Referenced by sendv_n. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; bytes_transferred = 0; iovec *iov = ACE_const_cast (iovec *, i); for (int s = 0; s < iovcnt; ) { // Try to transfer as much of the remaining data as possible. ssize_t n = ACE_OS::sendv (handle, iov + s, iovcnt - s); // Check EOF. if (n == 0) return 0; // Check for other errors. if (n == -1) { // Check for possible blocking. if (errno == EWOULDBLOCK || errno == ENOBUFS) { // Wait for the blocking to subside. int result = ACE::handle_write_ready (handle, 0); // Did select() succeed? if (result != -1) { // Blocking subsided. Continue data transfer. n = 0; continue; } } // Other data transfer or select() failures. return -1; } for (bytes_transferred += n; s < iovcnt && n >= ACE_static_cast (ssize_t, iov[s].iov_len); s++) n -= iov[s].iov_len; if (n != 0) { char *base = ACE_reinterpret_cast (char *, iov[s].iov_base); iov[s].iov_base = base + n; iov[s].iov_len = iov[s].iov_len - n; } } return bytes_transferred; }

int ACE::set_handle_limit (  int    new_limit = -1 )  [static]

Reset the limit on the number of open handles. If <new_limit> == -1 set the limit to the maximum allowable. Otherwise, set it to be the value of <new_limit>. Definition at line 3087 of file ACE.cpp. References ACE_TRACE, ACE_OS::getrlimit, max_handles, ACE_OS_String::memset, and ACE_OS::setrlimit. Referenced by ACE_POSIX_AIOCB_Proactor::check_max_aio_num, ACE_Select_Reactor_Handler_Repository::open, and ACE_Dev_Poll_Reactor_Handler_Repository::open. { ACE_TRACE ("ACE::set_handle_limit"); int cur_limit = ACE::max_handles (); int max_limit = cur_limit; if (cur_limit == -1) return -1; #if !defined (ACE_LACKS_RLIMIT) && defined (RLIMIT_NOFILE) struct rlimit rl; ACE_OS::memset ((void *) &rl, 0, sizeof rl); int r = ACE_OS::getrlimit (RLIMIT_NOFILE, &rl); if (r == 0) max_limit = rl.rlim_max; #endif /* ACE_LACKS_RLIMIT */ if (new_limit == -1) new_limit = max_limit; if (new_limit < 0) { errno = EINVAL; return -1; } else if (new_limit > cur_limit) { #if !defined (ACE_LACKS_RLIMIT) && defined (RLIMIT_NOFILE) rl.rlim_cur = new_limit; return ACE_OS::setrlimit (RLIMIT_NOFILE, &rl); #else // Must return EINVAL errno. ACE_NOTSUP_RETURN (-1); #endif /* ACE_LACKS_RLIMIT */ } else { #if !defined (ACE_LACKS_RLIMIT) && defined (RLIMIT_NOFILE) rl.rlim_cur = new_limit; return ACE_OS::setrlimit (RLIMIT_NOFILE, &rl); #else // We give a chance to platforms without RLIMIT to work. // Instead of ACE_NOTSUP_RETURN (0), just return 0 because // new_limit is <= cur_limit, so it's a no-op. return 0; #endif /* ACE_LACKS_RLIMIT */ } // Irix complains without this return statement. DEC cxx // (correctly) says that it's not reachable. ACE_NOTREACHED won't // work here, because it handles both platforms the same. // IRIX does not complain anymore [7.2] ACE_NOTREACHED (return 0); }

const ACE_TCHAR * ACE::sock_error (  int    error )  [static]

Returns a string containing the error message corresponding to a WinSock error. This works around an omission in the Win32 API... Definition at line 3232 of file ACE.cpp. References ACE_LIB_TEXT, ACE_TCHAR, and ACE_OS::sprintf. Referenced by ACE_Log_Msg::log. { #if defined (ACE_WIN32) static ACE_TCHAR unknown_msg[64]; switch (error) { case WSAVERNOTSUPPORTED: return ACE_LIB_TEXT ("version of WinSock not supported"); /* NOTREACHED */ case WSASYSNOTREADY: return ACE_LIB_TEXT ("WinSock not present or not responding"); /* NOTREACHED */ case WSAEINVAL: return ACE_LIB_TEXT ("app version not supported by DLL"); /* NOTREACHED */ case WSAHOST_NOT_FOUND: return ACE_LIB_TEXT ("Authoritive: Host not found"); /* NOTREACHED */ case WSATRY_AGAIN: return ACE_LIB_TEXT ("Non-authoritive: host not found or server failure"); /* NOTREACHED */ case WSANO_RECOVERY: return ACE_LIB_TEXT ("Non-recoverable: refused or not implemented"); /* NOTREACHED */ case WSANO_DATA: return ACE_LIB_TEXT ("Valid name, no data record for type"); /* NOTREACHED */ /* case WSANO_ADDRESS: return "Valid name, no MX record"; */ case WSANOTINITIALISED: return ACE_LIB_TEXT ("WSA Startup not initialized"); /* NOTREACHED */ case WSAENETDOWN: return ACE_LIB_TEXT ("Network subsystem failed"); /* NOTREACHED */ case WSAEINPROGRESS: return ACE_LIB_TEXT ("Blocking operation in progress"); /* NOTREACHED */ case WSAEINTR: return ACE_LIB_TEXT ("Blocking call cancelled"); /* NOTREACHED */ case WSAEAFNOSUPPORT: return ACE_LIB_TEXT ("address family not supported"); /* NOTREACHED */ case WSAEMFILE: return ACE_LIB_TEXT ("no file handles available"); /* NOTREACHED */ case WSAENOBUFS: return ACE_LIB_TEXT ("no buffer space available"); /* NOTREACHED */ case WSAEPROTONOSUPPORT: return ACE_LIB_TEXT ("specified protocol not supported"); /* NOTREACHED */ case WSAEPROTOTYPE: return ACE_LIB_TEXT ("protocol wrong type for this socket"); /* NOTREACHED */ case WSAESOCKTNOSUPPORT: return ACE_LIB_TEXT ("socket type not supported for address family"); /* NOTREACHED */ case WSAENOTSOCK: return ACE_LIB_TEXT ("handle is not a socket"); /* NOTREACHED */ case WSAEWOULDBLOCK: return ACE_LIB_TEXT ("socket marked as non-blocking and SO_LINGER set not 0"); /* NOTREACHED */ case WSAEADDRINUSE: return ACE_LIB_TEXT ("address already in use"); /* NOTREACHED */ case WSAECONNABORTED: return ACE_LIB_TEXT ("connection aborted"); /* NOTREACHED */ case WSAECONNRESET: return ACE_LIB_TEXT ("connection reset"); /* NOTREACHED */ case WSAENOTCONN: return ACE_LIB_TEXT ("not connected"); /* NOTREACHED */ case WSAETIMEDOUT: return ACE_LIB_TEXT ("connection timed out"); /* NOTREACHED */ case WSAECONNREFUSED: return ACE_LIB_TEXT ("connection refused"); /* NOTREACHED */ case WSAEHOSTDOWN: return ACE_LIB_TEXT ("host down"); /* NOTREACHED */ case WSAEHOSTUNREACH: return ACE_LIB_TEXT ("host unreachable"); /* NOTREACHED */ case WSAEADDRNOTAVAIL: return ACE_LIB_TEXT ("address not available"); /* NOTREACHED */ default: ACE_OS::sprintf (unknown_msg, ACE_LIB_TEXT ("unknown error: %d"), error); return unknown_msg; /* NOTREACHED */ } #else ACE_UNUSED_ARG (error); ACE_NOTSUP_RETURN (0); #endif /* ACE_WIN32 */ }

void ACE::strdelete (  wchar_t *    s )  [static]

Definition at line 3488 of file ACE.cpp. { delete [] s; }

void ACE::strdelete (  char *    s )  [static]

Delete the memory allocated by <strnew>. Definition at line 3481 of file ACE.cpp. Referenced by ACE_Framework_Component::~ACE_Framework_Component. { delete [] s; }

const wchar_t * ACE::strend (  const wchar_t *    s )  [static]

Definition at line 3439 of file ACE.cpp. References ACE_TEXT_WIDE. { while (*s++ != ACE_TEXT_WIDE ('\0')) continue; return s; }

const char * ACE::strend (  const char *    s )  [static]

Returns a pointer to the "end" of the string, i.e., the character past the '\0'. Definition at line 3429 of file ACE.cpp. { while (*s++ != '\0') continue; return s; }

ACE_TCHAR * ACE::strenvdup (  const ACE_TCHAR *    str )  [static]

Return a dynamically allocated duplicate of <str>, substituting the environment variable if <str[0] == '$'>. Note that the pointer is allocated with <ACE_OS::malloc> and must be freed by <ACE_OS::free>. Definition at line 516 of file ACE.cpp. References ACE_TCHAR, ACE_TRACE, and ACE_OS::strenvdup. { ACE_TRACE ("ACE::strenvdup"); return ACE_OS::strenvdup (str); }

wchar_t * ACE::strndup (  const wchar_t *    str, size_t    n )  [static]

Definition at line 3361 of file ACE.cpp. References ACE_ALLOCATOR_RETURN, ACE_OS_Memory::malloc, and ACE_OS_String::strsncpy. { const wchar_t *t = str; size_t len; // Figure out how long this string is (remember, it might not be // NUL-terminated). for (len = 0; len < n && *t++ != '\0'; len++) continue; wchar_t *s; ACE_ALLOCATOR_RETURN (s, ACE_static_cast (wchar_t *, ACE_OS::malloc ((len + 1) * sizeof (wchar_t))), 0); return ACE_OS::strsncpy (s, str, len + 1); }

char * ACE::strndup (  const char *    str, size_t    n )  [static]

Create a fresh new copy of <str>, up to <n> chars long. Uses <ACE_OS::malloc> to allocate the new string. Definition at line 3339 of file ACE.cpp. References ACE_ALLOCATOR_RETURN, ACE_OS_Memory::malloc, and ACE_OS_String::strsncpy. { const char *t = str; size_t len; // Figure out how long this string is (remember, it might not be // NUL-terminated). for (len = 0; len < n && *t++ != '\0'; len++) continue; char *s; ACE_ALLOCATOR_RETURN (s, (char *) ACE_OS::malloc (len + 1), 0); return ACE_OS::strsncpy (s, str, len + 1); }

wchar_t * ACE::strnew (  const wchar_t *    s )  [static]

Definition at line 3465 of file ACE.cpp. References ACE_NEW_RETURN, ACE_OS_String::strcpy, and ACE_OS_String::strlen. { if (s == 0) return 0; wchar_t *t = 0; ACE_NEW_RETURN (t, wchar_t[ACE_OS_String::strlen (s) + 1], 0); if (t == 0) return 0; else return ACE_OS::strcpy (t, s); }

char * ACE::strnew (  const char *    s )  [static]

This method is just like <strdup>, except that it uses <operator new> rather than <malloc>. If <s> is NULL returns NULL rather than segfaulting... Definition at line 3449 of file ACE.cpp. References ACE_NEW_RETURN, and ACE_OS_String::strcpy. Referenced by ACE_Function_Node::ACE_Function_Node, ACE_Logging_Strategy::ACE_Logging_Strategy, ACE_Object_Node::ACE_Object_Node, ACE_NT_Service::host, ACE_MEM_Acceptor::mmap_prefix, ACE_Service_Type_Impl::name, ACE_Service_Type::name, ACE_NT_Service::name, ACE_DLL_Handle::open, ACE_DLL::open_i, and ACE_Logging_Strategy::parse_args. { if (s == 0) return 0; char *t = 0; ACE_NEW_RETURN (t, char [::strlen (s) + 1], 0); if (t == 0) return 0; else return ACE_OS::strcpy (t, s); }

wchar_t * ACE::strnnew (  const wchar_t *    str, size_t    n )  [static]

Definition at line 3407 of file ACE.cpp. References ACE_NEW_RETURN, ACE_TEXT_WIDE, and ACE_OS_String::strsncpy. { const wchar_t *t = str; size_t len; // Figure out how long this string is (remember, it might not be // NUL-terminated). for (len = 0; len < n && *t++ != ACE_TEXT_WIDE ('\0'); len++) continue; wchar_t *s; ACE_NEW_RETURN (s, wchar_t[len + 1], 0); return ACE_OS::strsncpy (s, str, len + 1); }

char * ACE::strnnew (  const char *    str, size_t    n )  [static]

Create a fresh new copy of <str>, up to <n> chars long. Uses <ACE_OS::malloc> to allocate the new string. Definition at line 3385 of file ACE.cpp. References ACE_NEW_RETURN, and ACE_OS_String::strsncpy. { const char *t = str; size_t len; // Figure out how long this string is (remember, it might not be // NUL-terminated). for (len = 0; len < n && *t++ != L'\0'; len++) continue; char *s; ACE_NEW_RETURN (s, char[len + 1], 0); return ACE_OS::strsncpy (s, str, len + 1); }

ssize_t ACE::t_rcv (  ACE_HANDLE    handle, void *    buf, size_t    len, int *    flags, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 617 of file ACE.cpp. References enter_recv_timedwait, restore_non_blocking_mode, ssize_t, and ACE_OS_TLI::t_rcv. Referenced by ACE_TLI_Stream::recv. { if (timeout == 0) return ACE_OS::t_rcv (handle, (char *) buf, len, flags); else { int val = 0; if (ACE::enter_recv_timedwait (handle, timeout, val) ==-1) return -1; else { ssize_t bytes_transferred = ACE_OS::t_rcv (handle, (char *) buf, len, flags); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } } }

ssize_t ACE::t_rcv_n (  ACE_HANDLE    handle, void *    buf, size_t    len, int *    flags, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Referenced by ACE_TLI_Stream::recv_n.

ssize_t ACE::t_rcv_n_i (  ACE_HANDLE    handle, void *    buf, size_t    len, int *    flags, const ACE_Time_Value *    timeout, size_t *    bytes_transferred )  [static, private]

Definition at line 903 of file ACE.cpp. References EWOULDBLOCK, handle_read_ready, record_and_set_non_blocking_mode, restore_non_blocking_mode, ssize_t, and ACE_OS_TLI::t_rcv. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; ssize_t result = 0; int error = 0; int val = 0; ACE::record_and_set_non_blocking_mode (handle, val); for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. // Since the socket is in non-blocking mode, this call will not // block. n = ACE_OS::t_rcv (handle, (char *) buf + bytes_transferred, len - bytes_transferred, flags); // Check for errors. if (n == 0 || n == -1) { // Check for possible blocking. if (n == -1 && errno == EWOULDBLOCK) { // Wait upto <timeout> for the blocking to subside. int rtn = ACE::handle_read_ready (handle, timeout); // Did select() succeed? if (rtn != -1) { // Blocking subsided in <timeout> period. Continue // data transfer. n = 0; continue; } } // Wait in select() timed out or other data transfer or // select() failures. error = 1; result = n; break; } } ACE::restore_non_blocking_mode (handle, val); if (error) return result; else return bytes_transferred; }

ssize_t ACE::t_rcv_n_i (  ACE_HANDLE    handle, void *    buf, size_t    len, int *    flags, size_t *    bytes_transferred )  [static, private]

Definition at line 852 of file ACE.cpp. References EWOULDBLOCK, handle_read_ready, ssize_t, and ACE_OS_TLI::t_rcv. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. n = ACE_OS::t_rcv (handle, (char *) buf + bytes_transferred, len - bytes_transferred, flags); // Check EOF. if (n == 0) return 0; // Check for other errors. if (n == -1) { // Check for possible blocking. if (errno == EWOULDBLOCK) { // Wait for the blocking to subside. int result = ACE::handle_read_ready (handle, 0); // Did select() succeed? if (result != -1) { // Blocking subsided. Continue data transfer. n = 0; continue; } } // Other data transfer or select() failures. return -1; } } return bytes_transferred; }

ssize_t ACE::t_snd (  ACE_HANDLE    handle, const void *    buf, size_t    len, int    flags, const ACE_Time_Value *    timeout = 0 )  [static]

Definition at line 1428 of file ACE.cpp. References enter_send_timedwait, restore_non_blocking_mode, ssize_t, and ACE_OS_TLI::t_snd. Referenced by ACE_TLI_Stream::send. { if (timeout == 0) return ACE_OS::t_snd (handle, (const char *) buf, n, flags); else { int val = 0; if (ACE::enter_send_timedwait (handle, timeout, val) == -1) return -1; else { ssize_t bytes_transferred = ACE_OS::t_snd (handle, (const char *) buf, n, flags); ACE::restore_non_blocking_mode (handle, val); return bytes_transferred; } } }

ssize_t ACE::t_snd_n (  ACE_HANDLE    handle, const void *    buf, size_t    len, int    flags, const ACE_Time_Value *    timeout = 0, size_t *    bytes_transferred = 0 )  [static]

Referenced by ACE_TLI_Stream::send_n.

ssize_t ACE::t_snd_n_i (  ACE_HANDLE    handle, const void *    buf, size_t    len, int    flags, const ACE_Time_Value *    timeout, size_t *    bytes_transferred )  [static, private]

Definition at line 1714 of file ACE.cpp. References ENOBUFS, EWOULDBLOCK, handle_write_ready, record_and_set_non_blocking_mode, restore_non_blocking_mode, ssize_t, and ACE_OS_TLI::t_snd. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; ssize_t result = 0; int error = 0; int val = 0; ACE::record_and_set_non_blocking_mode (handle, val); for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. // Since the socket is in non-blocking mode, this call will not // block. n = ACE_OS::t_snd (handle, (char *) buf + bytes_transferred, len - bytes_transferred, flags); // Check for errors. if (n == 0 || n == -1) { // Check for possible blocking. if (n == -1 && errno == EWOULDBLOCK || errno == ENOBUFS) { // Wait upto <timeout> for the blocking to subside. int rtn = ACE::handle_write_ready (handle, timeout); // Did select() succeed? if (rtn != -1) { // Blocking subsided in <timeout> period. Continue // data transfer. n = 0; continue; } } // Wait in select() timed out or other data transfer or // select() failures. error = 1; result = n; break; } } ACE::restore_non_blocking_mode (handle, val); if (error) return result; else return bytes_transferred; }

ssize_t ACE::t_snd_n_i (  ACE_HANDLE    handle, const void *    buf, size_t    len, int    flags, size_t *    bytes_transferred )  [static, private]

Definition at line 1663 of file ACE.cpp. References ENOBUFS, EWOULDBLOCK, handle_write_ready, ssize_t, and ACE_OS_TLI::t_snd. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; ssize_t n; for (bytes_transferred = 0; bytes_transferred < len; bytes_transferred += n) { // Try to transfer as much of the remaining data as possible. n = ACE_OS::t_snd (handle, (char *) buf + bytes_transferred, len - bytes_transferred, flags); // Check EOF. if (n == 0) return 0; // Check for other errors. if (n == -1) { // Check for possible blocking. if (errno == EWOULDBLOCK || errno == ENOBUFS) { // Wait for the blocking to subside. int result = ACE::handle_write_ready (handle, 0); // Did select() succeed? if (result != -1) { // Blocking subsided. Continue data transfer. n = 0; continue; } } // Other data transfer or select() failures. return -1; } } return bytes_transferred; }

int ACE::terminate_process (  pid_t    pid )  [static]

Terminate the process abruptly with id <pid>. On Win32 platforms this uses <TerminateProcess> and on POSIX platforms is uses <kill> with the -9 (SIGKILL) signal, which cannot be caught or ignored. Note that this call is potentially dangerous to use since the process being terminated may not have a chance to cleanup before it shuts down. Definition at line 179 of file ACE.cpp. References ACE_OS::close, ACE_OS::kill, and pid_t. Referenced by ACE_Process_Manager::terminate, and ACE_Process::terminate. { #if defined (ACE_HAS_PHARLAP) ACE_UNUSED_ARG (pid); ACE_NOTSUP_RETURN (-1); #elif defined (ACE_WIN32) // Create a handle for the given process id. ACE_HANDLE process_handle = ::OpenProcess (PROCESS_TERMINATE, FALSE, // New handle is not inheritable. pid); if (process_handle == ACE_INVALID_HANDLE || process_handle == 0) return -1; else { // Kill the process associated with process_handle. BOOL terminate_result = ::TerminateProcess (process_handle, 0); // Free up the kernel resources. ACE_OS::close (process_handle); return terminate_result; } #elif defined (CHORUS) KnCap cap_; // Use the pid to find out the actor's capability, then kill it. # if defined(CHORUS_4) if (::acap (pid, &cap_) == 0) # else if (::acap (AM_MYSITE, pid, &cap_) == 0) # endif return ::akill (&cap_); else return -1; #else return ACE_OS::kill (pid, 9); #endif /* ACE_HAS_PHARLAP */ }

ACE_TCHAR * ACE::timestamp (  ACE_TCHAR    date_and_time[], int    time_len, int    return_pointer_to_first_digit = 0 )  [static]

Returns the current timestamp in the form "hour:minute:second:microsecond." The month, day, and year are also stored in the beginning of the <date_and_time> array, which is a user-supplied array of size <time_len> <ACE_TCHAR>s. Returns 0 if unsuccessful, else returns pointer to beginning of the "time" portion of <date_and_time>. If <return_pointer_to_first_digit> is 0 then return a pointer to the space before the time, else return a pointer to the beginning of the time portion. Definition at line 2603 of file ACE.cpp. References ACE_LIB_TEXT, ACE_TCHAR, ACE_OS::ctime_r, ACE_OS::gettimeofday, ACE_Time_Value::sec, ACE_OS::sprintf, ACE_OS_String::strsncpy, and ACE_Time_Value::usec. Referenced by ACE_Log_Msg::log. { //ACE_TRACE ("ACE::timestamp"); if (date_and_timelen < 35) { errno = EINVAL; return 0; } #if defined (WIN32) // Emulate Unix. Win32 does NOT support all the UNIX versions // below, so DO we need this ifdef. static const ACE_TCHAR *day_of_week_name[] = { ACE_LIB_TEXT ("Sun"), ACE_LIB_TEXT ("Mon"), ACE_LIB_TEXT ("Tue"), ACE_LIB_TEXT ("Wed"), ACE_LIB_TEXT ("Thu"), ACE_LIB_TEXT ("Fri"), ACE_LIB_TEXT ("Sat") }; static const ACE_TCHAR *month_name[] = { ACE_LIB_TEXT ("Jan"), ACE_LIB_TEXT ("Feb"), ACE_LIB_TEXT ("Mar"), ACE_LIB_TEXT ("Apr"), ACE_LIB_TEXT ("May"), ACE_LIB_TEXT ("Jun"), ACE_LIB_TEXT ("Jul"), ACE_LIB_TEXT ("Aug"), ACE_LIB_TEXT ("Sep"), ACE_LIB_TEXT ("Oct"), ACE_LIB_TEXT ("Nov"), ACE_LIB_TEXT ("Dec") }; SYSTEMTIME local; ::GetLocalTime (&local); ACE_OS::sprintf (date_and_time, ACE_LIB_TEXT ("%3s %3s %2d %04d %02d:%02d:%02d.%06d"), day_of_week_name[local.wDayOfWeek], month_name[local.wMonth - 1], (int) local.wDay, (int) local.wYear, (int) local.wHour, (int) local.wMinute, (int) local.wSecond, (int) (local.wMilliseconds * 1000)); return &date_and_time[15 + (return_pointer_to_first_digit != 0)]; #else /* UNIX */ ACE_TCHAR timebuf[26]; // This magic number is based on the ctime(3c) man page. ACE_Time_Value cur_time = ACE_OS::gettimeofday (); time_t secs = cur_time.sec (); ACE_OS::ctime_r (&secs, timebuf, sizeof timebuf); // date_and_timelen > sizeof timebuf! ACE_OS::strsncpy (date_and_time, timebuf, date_and_timelen); char yeartmp[5]; ACE_OS::strsncpy (yeartmp, &date_and_time[20], 5); char timetmp[9]; ACE_OS::strsncpy (timetmp, &date_and_time[11], 9); ACE_OS::sprintf (&date_and_time[11], "%s %s.%06ld", yeartmp, timetmp, cur_time.usec ()); date_and_time[33] = '\0'; return &date_and_time[15 + (return_pointer_to_first_digit != 0)]; #endif /* WIN32 */ }

ASYS_INLINE void ACE::unique_name (  const void *    object, ACE_TCHAR *    name, size_t    length )  [static]

This method uses process id and object pointer to come up with a machine wide unique name. The process ID will provide uniqueness between processes on the same machine. The "this" pointer of the <object> will provide uniqueness between other "live" objects in the same process. The uniqueness of this name is therefore only valid for the life of <object>. Definition at line 264 of file ACE.i. References ACE_TCHAR, and ACE_OS::unique_name. Referenced by ACE_Semaphore::ACE_Semaphore, ACE_RW_Process_Mutex::unique_name, and ACE_Process_Mutex::unique_name. { ACE_OS::unique_name (object, name, length); }

ssize_t ACE::write_n (  ACE_HANDLE    handle, const ACE_Message_Block *    message_block, size_t *    bytes_transferred = 0 )  [static]

Write all the <message_block>s chained through their <next> and <cont> pointers. This call uses the underlying OS gather-write operation to reduce the domain-crossing penalty. Definition at line 2109 of file ACE.cpp. References ACE_IOV_MAX, ACE_Message_Block::cont, iovec::iov_base, iovec::iov_len, ACE_Message_Block::length, ACE_Message_Block::next, ACE_Message_Block::rd_ptr, ssize_t, and writev_n. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; bytes_transferred = 0; iovec iov[ACE_IOV_MAX]; int iovcnt = 0; while (message_block != 0) { // Our current message block chain. const ACE_Message_Block *current_message_block = message_block; while (current_message_block != 0) { size_t current_message_block_length = current_message_block->length (); char *this_block_ptr = current_message_block->rd_ptr (); // Check if this block has any data to be sent. while (current_message_block_length > 0) { u_long this_chunk_length; if (current_message_block_length > ULONG_MAX) this_chunk_length = ULONG_MAX; else this_chunk_length = ACE_static_cast (u_long, current_message_block_length); // Collect the data in the iovec. iov[iovcnt].iov_base = this_block_ptr; iov[iovcnt].iov_len = this_chunk_length; current_message_block_length -= this_chunk_length; this_block_ptr += this_chunk_length; // Increment iovec counter. iovcnt++; // The buffer is full make a OS call. @@ TODO find a way to // find ACE_IOV_MAX for platforms that do not define it rather // than simply setting ACE_IOV_MAX to some arbitrary value such // as 16. if (iovcnt == ACE_IOV_MAX) { size_t current_transfer = 0; ssize_t result = ACE::writev_n (handle, iov, iovcnt, &current_transfer); // Add to total bytes transferred. bytes_transferred += current_transfer; // Errors. if (result == -1 || result == 0) return result; // Reset iovec counter. iovcnt = 0; } } // Select the next message block in the chain. current_message_block = current_message_block->cont (); } // Selection of the next message block chain. message_block = message_block->next (); } // Check for remaining buffers to be sent. This will happen when // ACE_IOV_MAX is not a multiple of the number of message blocks. if (iovcnt != 0) { size_t current_transfer = 0; ssize_t result = ACE::writev_n (handle, iov, iovcnt, &current_transfer); // Add to total bytes transferred. bytes_transferred += current_transfer; // Errors. if (result == -1 || result == 0) return result; } // Return total bytes transferred. return bytes_transferred; }

ASYS_INLINE ssize_t ACE::write_n (  ACE_HANDLE    handle, const void *    buf, size_t    len, size_t *    bytes_transferred = 0 )  [static]

Definition at line 19 of file ACE.i. References ACE_OS::write_n. Referenced by ACE_SPIPE_Stream::send_n, ACE_FILE_IO::send_n, and ACE_DEV_IO::send_n. { return ACE_OS::write_n (handle, buf, len, bytes_transferred); }

ssize_t ACE::writev_n (  ACE_HANDLE    handle, const iovec *    iov, int    iovcnt, size_t *    bytes_transferred = 0 )  [static]

Definition at line 2346 of file ACE.cpp. References iovec::iov_base, iovec::iov_len, ssize_t, and ACE_OS::writev. Referenced by ACE_SPIPE_Stream::sendv_n, ACE_FILE_IO::sendv_n, and write_n. { size_t temp; size_t &bytes_transferred = bt == 0 ? temp : *bt; bytes_transferred = 0; iovec *iov = ACE_const_cast (iovec *, i); for (int s = 0; s < iovcnt; ) { ssize_t n = ACE_OS::writev (handle, iov + s, iovcnt - s); if (n == -1 || n == 0) return n; for (bytes_transferred += n; s < iovcnt && n >= ACE_static_cast (ssize_t, iov[s].iov_len); s++) n -= iov[s].iov_len; if (n != 0) { char *base = ACE_reinterpret_cast (char *, iov[s].iov_base); iov[s].iov_base = base + n; iov[s].iov_len = iov[s].iov_len - n; } } return bytes_transferred; }

---

Member Data Documentation

size_t ACE::allocation_granularity_ = 0 [static, private]

Size of allocation granularity. Definition at line 31 of file ACE.cpp. Referenced by round_to_allocation_granularity.

u_long ACE::crc_table_ [static, private]

CRC table. Definition at line 381 of file ACE.cpp.

char ACE::debug_ = 0 [static, private]

Are we debugging ACE? Definition at line 22 of file ACE.cpp. Referenced by debug.

const ACE_TCHAR ACE::hex_chars_ = ACE_LIB_TEXT ("0123456789abcdef") [static, private]

Hex characters. Definition at line 25 of file ACE.cpp. Referenced by nibble2hex.

size_t ACE::pagesize_ = 0 [static, private]

Size of a VM page. Definition at line 28 of file ACE.cpp. Referenced by round_to_pagesize.

---

The documentation for this class was generated from the following files:

• ACE.h
• ACE.cpp
• ACE.i

---