/*

    atarisio - A UNIX backend for an Atari SIO2PC lead.

    Copyright (C) 2004  Ian Cowburn (ianc@noddybox.demon.co.uk)

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    -------------------------------------------------------------------------

    Global utilities and types

*/

#ifndef ATARISIO_UTIL_H
#define ATARISIO_UTIL_H "$Id$"

#include <stdlib.h>

/* ---------------------------------------- TYPES
*/

typedef unsigned char	uchar;


/* ---------------------------------------- INTERFACES
*/

/* Returns result from malloc(size), calling exit() if it fails.
*/
void		*Malloc(size_t size);


/* Returns result from realloc(p,size), calling exit() if it fails.
*/
void		*Realloc(void *p, size_t size);


/* Copies a string.  The result must be freed.
*/
char		*StrCopy(const char *source);


/* Set flag TRUE/FALSE depending on the contents of str.
   'on', 'yes' and '1' are TRUE, 'off', 'no' and '0' false.

   Returns FALSE is str is invalid.
*/
int		YesNo(const char *str, int *flag);


/* Hex dump to stdout
*/
void		HexDump(const uchar *p, size_t len);


/* Get an integer from a string
*/
int		GetInt(const char *p);


/* Returns an Atari serial style checksum.
*/
uchar		Checksum(const uchar *p, size_t len);


#endif


/* END OF FILE */