/*
- * "$Id: file.h 5319 2006-03-21 15:28:29Z mike $"
+ * Public file definitions for CUPS.
*
- * Public file definitions for the Common UNIX Printing System (CUPS).
+ * Since stdio files max out at 256 files on many systems, we have to
+ * write similar functions without this limit. At the same time, using
+ * our own file functions allows us to provide transparent support of
+ * different line endings, gzip'd print files, PPD files, etc.
*
- * Since stdio files max out at 256 files on many systems, we have to
- * write similar functions without this limit. At the same time, using
- * our own file functions allows us to provide transparent support of
- * gzip'd print files, PPD files, etc.
+ * Copyright 2007-2017 by Apple Inc.
+ * Copyright 1997-2007 by Easy Software Products, all rights reserved.
*
- * Copyright 1997-2005 by Easy Software Products, all rights reserved.
+ * These coded instructions, statements, and computer programs are the
+ * property of Apple Inc. and are protected by Federal copyright
+ * law. Distribution and use rights are outlined in the file "LICENSE.txt"
+ * which should have been included with this file. If this file is
+ * missing or damaged, see the license at "http://www.cups.org/".
*
- * These coded instructions, statements, and computer programs are the
- * property of Easy Software Products and are protected by Federal
- * copyright law. Distribution and use rights are outlined in the file
- * "LICENSE.txt" which should have been included with this file. If this
- * file is missing or damaged please contact Easy Software Products
- * at:
- *
- * Attn: CUPS Licensing Information
- * Easy Software Products
- * 44141 Airport View Drive, Suite 204
- * Hollywood, Maryland 20636 USA
- *
- * Voice: (301) 373-9600
- * EMail: cups-info@cups.org
- * WWW: http://www.cups.org
+ * This file is subject to the Apple OS-Developed Software exception.
*/
#ifndef _CUPS_FILE_H_
* Include necessary headers...
*/
+# include "versioning.h"
+# include <stddef.h>
# include <sys/types.h>
-
-# ifdef WIN32
+# if defined(WIN32) && !defined(__CUPS_SSIZE_T_DEFINED)
+# define __CUPS_SSIZE_T_DEFINED
/* Windows does not support the ssize_t type, so map it to off_t... */
typedef off_t ssize_t; /* @private@ */
-# endif /* WIN32 */
+# endif /* WIN32 && !__CUPS_SSIZE_T_DEFINED */
/*
* C++ magic...
*/
-# ifdef _cplusplus
+# ifdef __cplusplus
extern "C" {
-# endif /* _cplusplus */
+# endif /* __cplusplus */
/*
* Prototypes...
*/
-extern int cupsFileClose(cups_file_t *fp);
-extern int cupsFileCompression(cups_file_t *fp);
-extern int cupsFileEOF(cups_file_t *fp);
+extern int cupsFileClose(cups_file_t *fp) _CUPS_API_1_2;
+extern int cupsFileCompression(cups_file_t *fp) _CUPS_API_1_2;
+extern int cupsFileEOF(cups_file_t *fp) _CUPS_API_1_2;
extern const char *cupsFileFind(const char *filename, const char *path,
int executable, char *buffer,
- int bufsize);
-extern int cupsFileFlush(cups_file_t *fp);
-extern int cupsFileGetChar(cups_file_t *fp);
-extern char *cupsFileGetConf(cups_file_t *fp, char *buf, size_t buflen,
- char **value, int *linenum);
+ int bufsize) _CUPS_API_1_2;
+extern int cupsFileFlush(cups_file_t *fp) _CUPS_API_1_2;
+extern int cupsFileGetChar(cups_file_t *fp) _CUPS_API_1_2;
+extern char *cupsFileGetConf(cups_file_t *fp, char *buf,
+ size_t buflen, char **value,
+ int *linenum) _CUPS_API_1_2;
extern size_t cupsFileGetLine(cups_file_t *fp, char *buf,
- size_t buflen);
-extern char *cupsFileGets(cups_file_t *fp, char *buf, size_t buflen);
-extern int cupsFileLock(cups_file_t *fp, int block);
-extern int cupsFileNumber(cups_file_t *fp);
-extern cups_file_t *cupsFileOpen(const char *filename, const char *mode);
-extern cups_file_t *cupsFileOpenFd(int fd, const char *mode);
-extern int cupsFilePeekChar(cups_file_t *fp);
-extern int cupsFilePrintf(cups_file_t *fp, const char *format, ...);
-extern int cupsFilePutChar(cups_file_t *fp, int c);
-extern int cupsFilePuts(cups_file_t *fp, const char *s);
-extern ssize_t cupsFileRead(cups_file_t *fp, char *buf, size_t bytes);
-extern off_t cupsFileRewind(cups_file_t *fp);
-extern off_t cupsFileSeek(cups_file_t *fp, off_t pos);
-extern cups_file_t *cupsFileStderr(void);
-extern cups_file_t *cupsFileStdin(void);
-extern cups_file_t *cupsFileStdout(void);
-extern off_t cupsFileTell(cups_file_t *fp);
-extern int cupsFileUnlock(cups_file_t *fp);
-extern ssize_t cupsFileWrite(cups_file_t *fp, const char *buf, size_t bytes);
-
-
-# ifdef _cplusplus
+ size_t buflen) _CUPS_API_1_2;
+extern char *cupsFileGets(cups_file_t *fp, char *buf, size_t buflen)
+ _CUPS_API_1_2;
+extern int cupsFileLock(cups_file_t *fp, int block) _CUPS_API_1_2;
+extern int cupsFileNumber(cups_file_t *fp) _CUPS_API_1_2;
+extern cups_file_t *cupsFileOpen(const char *filename, const char *mode)
+ _CUPS_API_1_2;
+extern cups_file_t *cupsFileOpenFd(int fd, const char *mode) _CUPS_API_1_2;
+extern int cupsFilePeekChar(cups_file_t *fp) _CUPS_API_1_2;
+extern int cupsFilePrintf(cups_file_t *fp, const char *format, ...)
+ __attribute__((__format__ (__printf__, 2, 3)))
+ _CUPS_API_1_2;
+extern int cupsFilePutChar(cups_file_t *fp, int c) _CUPS_API_1_2;
+extern ssize_t cupsFilePutConf(cups_file_t *fp, const char *directive,
+ const char *value) _CUPS_API_1_4;
+extern int cupsFilePuts(cups_file_t *fp, const char *s)
+ _CUPS_API_1_2;
+extern ssize_t cupsFileRead(cups_file_t *fp, char *buf, size_t bytes)
+ _CUPS_API_1_2;
+extern off_t cupsFileRewind(cups_file_t *fp) _CUPS_API_1_2;
+extern off_t cupsFileSeek(cups_file_t *fp, off_t pos) _CUPS_API_1_2;
+extern cups_file_t *cupsFileStderr(void) _CUPS_API_1_2;
+extern cups_file_t *cupsFileStdin(void) _CUPS_API_1_2;
+extern cups_file_t *cupsFileStdout(void) _CUPS_API_1_2;
+extern off_t cupsFileTell(cups_file_t *fp) _CUPS_API_1_2;
+extern int cupsFileUnlock(cups_file_t *fp) _CUPS_API_1_2;
+extern ssize_t cupsFileWrite(cups_file_t *fp, const char *buf,
+ size_t bytes) _CUPS_API_1_2;
+
+
+# ifdef __cplusplus
}
-# endif /* _cplusplus */
+# endif /* __cplusplus */
#endif /* !_CUPS_FILE_H_ */
-
-/*
- * End of "$Id: file.h 5319 2006-03-21 15:28:29Z mike $".
- */