t_alloc man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

t_alloc(3)							    t_alloc(3)

       t_alloc() - allocate transport function library structure

       — or —

       The  function  dynamically  allocates  memory for the various transport
       function argument structures as specified below.	  This	function  will
       allocate memory for the specified structure and will also allocate mem‐
       ory for buffers referenced by the structure.

       The structure to allocate is specified by struct_type and must  be  one
       of the following:

	      T_BIND	   struct   t_bind
	      T_CALL	   struct   t_call
	      T_DIS	   struct   t_discon
	      T_INFO	   struct   t_info
	      T_OPTMGMT	   struct   t_optmgmt
	      T_UDERROR	   struct   t_uderr
	      T_UNITDATA   struct   t_unitdata

       where  each of these structures may subsequently be used as an argument
       to one or more transport functions.

       Each of the above structures, except  T_INFO,  contains	at  least  one
       field  of  type	For each field of this type, the user may specify that
       the buffer for that field should be allocated as well.  The  length  of
       the  buffer  allocated will be equal to or greater than the appropriate
       size returned in the info argument of or The  relevant  fields  of  the
       info argument are described in the following list.  The fields argument
       specifies which buffer to allocate, where the argument is the  bitwise-
       OR of any of the following:

       The		   addr field of the or structures.

       The		   opt field of the or structures.

       The		   udata field of the or structures.

       All relevant fields of the given structure.
			   Fields  which  are  not  supported  by  e transport
			   provider specified by  fd  will  not	 be  allocated
			   (info values are <= 0).

       For each field specified in fields, will allocate memory for the buffer
       associated with the field, and initialize the len field to zero and the
       buf pointer and maxlen field accordingly.  Since the length of the buf‐
       fer allocated will be based  on	the  same  size	 information  that  is
       returned	 to  the  user	on  or fd must refer to the transport endpoint
       through which the newly allocated structure will be  passed.   In  this
       way  the	 appropriate  size  information	 can be accessed.  If the size
       value associated with any specified field is −1 or −2 (	see  t_open(3)
       or t_getinfo(3)), will be unable to determine the size of the buffer to
       allocate and will fail, setting to and to For any field	not  specified
       in  fields, buf will be set to a null pointer and maxlen will be set to

       Use of to allocate structures will help	ensure	the  compatibility  of
       user  programs  with  future  releases of the transport interface func‐

   Valid States
       All, apart from

   Fork Safety
       is not fork-safe.

       Upon successful completion, returns a pointer to	 the  newly  allocated
       structure.  On failure, a null pointer is returned.

       On failure, is set to one of the following:

       fd,	      the  specified  endpoint identifier, does not refer to a
		      transport endpoint.

       A system error has occurred during execution of this function.

       (XTI only) This error indicates that a communication problem  has  been
		      between  XTI  and the transport provider for which there
		      is no suitable XTI

       Unsupported    struct_type requested.  This can include a request for a
		      structure	 type which is inconsistent with the transport
		      provider type specified, that is, connection-oriented or

       t_free(3), t_getinfo(3), t_open(3), thread_safety(5).


List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net