00001 /* 00002 * SpanDSP - a series of DSP components for telephony 00003 * 00004 * t30_logging.h - definitions for T.30 fax processing 00005 * 00006 * Written by Steve Underwood <steveu@coppice.org> 00007 * 00008 * Copyright (C) 2003 Steve Underwood 00009 * 00010 * All rights reserved. 00011 * 00012 * This program is free software; you can redistribute it and/or modify 00013 * it under the terms of the GNU Lesser General Public License version 2.1, 00014 * as published by the Free Software Foundation. 00015 * 00016 * This program is distributed in the hope that it will be useful, 00017 * but WITHOUT ANY WARRANTY; without even the implied warranty of 00018 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 00019 * GNU Lesser General Public License for more details. 00020 * 00021 * You should have received a copy of the GNU Lesser General Public 00022 * License along with this program; if not, write to the Free Software 00023 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 00024 * 00025 * $Id: t30_logging.h,v 1.2 2008/04/17 14:27:00 steveu Exp $ 00026 */ 00027 00028 /*! \file */ 00029 00030 #if !defined(_SPANDSP_T30_LOGGING_H_) 00031 #define _SPANDSP_T30_LOGGING_H_ 00032 00033 #if defined(__cplusplus) 00034 extern "C" 00035 { 00036 #endif 00037 00038 /*! Return a text name for a T.30 frame type. 00039 \brief Return a text name for a T.30 frame type. 00040 \param x The frametype octet. 00041 \return A pointer to the text name for the frame type. If the frame type is 00042 not value, the string "???" is returned. */ 00043 const char *t30_frametype(uint8_t x); 00044 00045 /*! Decode a DIS, DTC or DCS frame, and log the contents. 00046 \brief Decode a DIS, DTC or DCS frame, and log the contents. 00047 \param s The T.30 context. 00048 \param dis A pointer to the frame to be decoded. 00049 \param len The length of the frame. */ 00050 void t30_decode_dis_dtc_dcs(t30_state_t *s, const uint8_t *dis, int len); 00051 00052 /*! Convert a phase E completion code to a short text description. 00053 \brief Convert a phase E completion code to a short text description. 00054 \param result The result code. 00055 \return A pointer to the description. */ 00056 const char *t30_completion_code_to_str(int result); 00057 00058 #if defined(__cplusplus) 00059 } 00060 #endif 00061 00062 #endif 00063 /*- End of file ------------------------------------------------------------*/