Return to _putput.c CVS log

Up to [MW Coherent from dump] / coherent / f / etc / conf / streams / src

Annotation of coherent/f/etc/conf/streams/src/_putput.c, revision 1.1.1.1

1.1       root        1: #define        _DDI_DKI        1
                      2: #define        _SYSV4          1
                      3: 
                      4: /*
                      5:  * Simple im-memory traceback buffer for kernel debugging.
                      6:  *
                      7:  * This module exists to service the DDI/DKI cmn_err () function, which takes
                      8:  * care of details like locking. This function is a simple debugging output
                      9:  * which logs characters to a wrap-around memory buffer that might be useful
                     10:  * for post-mortem kernel debugging.
                     11:  */
                     12: 
                     13: /*
                     14:  *-IMPORTS:
                     15:  *     <common/ccompat.h>
                     16:  *             __USE_PROTO__
                     17:  *             __ARGS ()
                     18:  *     <common/xdebug.h>
                     19:  *             __LOCAL__
                     20:  */
                     21: 
                     22: #include <common/ccompat.h>
                     23: #include <common/xdebug.h>
                     24: 
                     25: 
                     26: #ifndef        DEBUG_BUF_SIZE
                     27: #define        DEBUG_BUF_SIZE  1024
                     28: #endif
                     29: 
                     30: 
                     31: #define        SIGNATURE       "$PUTBUF:"
                     32: 
                     33: 
                     34: /*
                     35:  * Local state for the simple debug output.
                     36:  */
                     37: 
                     38: __LOCAL__ struct {
                     39:        unsigned char   signature [sizeof (SIGNATURE)];
                     40:        unsigned        offset;
                     41:        unsigned char   buffer [DEBUG_BUF_SIZE];
                     42: } _putbuf = {
                     43:        SIGNATURE
                     44: };
                     45: 
                     46: 
                     47: /*
                     48:  *-STATUS:
                     49:  *     Private to cmn_err ()
                     50:  *
                     51:  *-NAME:
                     52:  *     _put_putbuf ()  simple post-mortem debugging output
                     53:  *
                     54:  *-ARGUMENTS:
                     55:  *     outch           The character to record in the post-mortem traceback
                     56:  *                     buffer.
                     57:  *
                     58:  *-DESCRIPTION:
                     59:  *     This function provides system-specific debugging output support for
                     60:  *     the DDI/DKI cnm_err () function, interfacing to a simple wraparound
                     61:  *     traceback buffer.
                     62:  *
                     63:  *-NOTES:
                     64:  *     This function does not sleep.
                     65:  *
                     66:  *     Driver-defined basic locks, read/write locks and sleep locks may
                     67:  *     be held across calls to this function.
                     68:  *
                     69:  *     In systems where the contents of main memory are not usually
                     70:  *     available after a crash and restart, the traceback memory may be
                     71:  *     stored off-line (recorded through a serial port), or checkpointed
                     72:  *     into memory not touched by the system boot process (such as network
                     73:  *     adapter buffer memory). In such systems, the traceback output may
                     74:  *     be "buffered" and only flushed when requested to record a '\n'
                     75:  */
                     76: 
                     77: #if    __USE_PROTO__
                     78: void (_put_putbuf) (unsigned char outch)
                     79: #else
                     80: void
                     81: _put_putbuf __ARGS ((outch))
                     82: unsigned char  outch;
                     83: #endif
                     84: {
                     85:        _putbuf.buffer [_putbuf.offset] = outch;
                     86:        _putbuf.offset = (_putbuf.offset + 1) % sizeof (_putbuf.buffer);
                     87: }

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.