workbench/network/stacks/AROSTCP/bsdsocket/api/auto_nonsocket.c

   1
   2 /****** bsdsocket.library/getdtablesize *************************************
   3
   4     NAME
   5         getdtablesize - get socket descriptor table size
   6
   7     SYNOPSIS
   8
   9         nfds = getdtablesize()
  10         D0
  11
  12         long getdtablesize(void);
  13
  14     FUNCTION
  15         Return value of maximum  number of open socket  descriptors.
  16         Larger  socket  descriptor  table  can   be  allocated  with
  17         SocketBaseTagList() call.
  18
  19     SEE ALSO
  20         SocketBaseTagList()
  21
  22 *****************************************************************************
  23 *
  24 */
  25
  26 /****** bsdsocket.library/syslog ********************************************
  27
  28     NAME
  29         syslog, vsyslog - write message to AmiTCP/IP log.
  30
  31     SYNOPSIS
  32         #include <syslog.h>
  33
  34         vsyslog(level, format, ap)
  35                 D0     A0      A1
  36
  37         void syslog(unsigned long level, char * format, ...);
  38
  39         void vsyslog(unsigned long level, char * format, ap);
  40
  41     FUNCTION
  42         Writes the message given as format string and arguments
  43         (printf-style) both to the log file and to the console.
  44         The message is prepended with the name of the calling
  45         application, if the name is known by AmiTCP (the standard
  46         autoinitiazer module in the net.lib passes the name of the
  47         application to AmiTCP).
  48
  49         The level is selected from an ordered list:
  50
  51             LOG_EMERG           A panic condition.
  52
  53             LOG_ALERT           A condition that should be
  54                                 corrected immediately, such as a
  55                                 corrupted system database.
  56
  57             LOG_CRIT            Critical conditions, such  as  hard
  58                                 device errors.
  59
  60             LOG_ERR             Errors.
  61
  62             LOG_WARNING         Warning messages.
  63
  64             LOG_NOTICE          Conditions that are not error  con-
  65                                 ditions,  but that may require spe-
  66                                 cial handling.
  67
  68             LOG_INFO            Informational messages.
  69
  70             LOG_DEBUG           Messages that  contain  information
  71                                 normally of use only when debugging
  72                                 a program.
  73
  74     INPUTS
  75         Level     - indicates the type of the message. The levels
  76                     are defined in sys/syslog.h and listed above.
  77
  78         format    - This is a printf-style format string.
  79
  80         arguments - as in printf().
  81
  82         ap        - pointer to an array of arguments.
  83
  84     RESULT
  85         Returns no value.
  86
  87     EXAMPLES
  88         To log a message at priority LOG_INFO, it would make the
  89         following call to syslog:
  90
  91             syslog(LOG_INFO,  "Connection from host %s",
  92                    CallingHost);
  93
  94     NOTES
  95         In contrast to the previous releases of the AmiTCP/IP, the
  96         integer arguments are expected to be 32 bits wide, thus
  97         eliminating the need to specify the 'l' size modifier for the
  98         number formatters.
  99
 100         This function is callable from interrupts.
 101
 102     BUGS
 103         Because there is a limited number of internal messages used
 104         by the logging system, some log messages may get lost if a
 105         high priority task or interrupt handler sends many messages
 106         in succession. If this happens, the next log message tells
 107         the fact.
 108
 109     SEE ALSO
 110         net.lib/syslog for syslog utility functions (openlog(),
 111         closelog() and setlogmask()),
 112         C-library printf() documentation
 113
 114 *****************************************************************************
 115 *
 116 */