X-Git-Url: http://git.silcnet.org/gitweb/?a=blobdiff_plain;f=lib%2Fsilcutil%2Fsilcfileutil.h;h=80e9d99a45be468e4ec1a3942af1bf135b8e2797;hb=e9374395ec9747bddd3ea0bfd3e5a17717e97b31;hp=80624ed5e89f0d3bb247077f75e0d01be73a20b3;hpb=67ead87b5688a88f997ed02252625e1ebb882de4;p=silc.git

diff --git a/lib/silcutil/silcfileutil.h b/lib/silcutil/silcfileutil.h
index 80624ed5..80e9d99a 100644
--- a/lib/silcutil/silcfileutil.h
+++ b/lib/silcutil/silcfileutil.h
@@ -1,10 +1,10 @@
 /*
 
-  silcfileutil.h 
+  silcfileutil.h
 
   Author: Pekka Riikonen <priikone@silcnet.org>
 
-  Copyright (C) 1997 - 2002 Pekka Riikonen
+  Copyright (C) 1997 - 2005 Pekka Riikonen
 
   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
@@ -17,10 +17,12 @@
 
 */
 
-/****h* silcutil/Silc File Util Interface
+/****h* silcutil/SILC File Util Interface
  *
  * DESCRIPTION
  *
+ *    The SILC File Util Interface is a small set of functions that provides a
+ *    portable access method to the filesystem.
  *
  ***/
 
@@ -29,15 +31,150 @@
 
 /* Prototypes */
 
+/****f* silcutil/SilcFileUtilAPI/silc_file_open
+ *
+ * SYNOPSIS
+ *
+ *    int silc_file_open(const char *filename, int flags);
+ *
+ * DESCRIPTION
+ *
+ *    Opens a file indicated by the filename `filename' with flags indicated
+ *    by `flags'.  The opening permission defaults to 0600.  The `flags'
+ *    are defined in open(2).
+ *
+ ***/
 int silc_file_open(const char *filename, int flags);
+
+/****f* silcutil/SilcFileUtilAPI/silc_file_open_mode
+ *
+ * SYNOPSIS
+ *
+ *    int silc_file_open_mode(const char *filename, int flags, int mode);
+ *
+ * DESCRIPTION
+ *
+ *    Opens a file indicated by the filename `filename' with flags indicated
+ *    by `flags'.  The argument `mode' specifies the permissions to use in
+ *    case a new file is created.  The `flags' are defined in open(2).
+ *
+ ***/
 int silc_file_open_mode(const char *filename, int flags, int mode);
+
+/****f* silcutil/SilcFileUtilAPI/silc_file_read
+ *
+ * SYNOPSIS
+ *
+ *    int silc_file_read(int fd, unsigned char *buf, SilcUInt32 buf_len);
+ *
+ * DESCRIPTION
+ *
+ *    Reads data from file descriptor `fd' to `buf'.
+ *
+ ***/
 int silc_file_read(int fd, unsigned char *buf, SilcUInt32 buf_len);
+
+/****f* silcutil/SilcFileUtilAPI/silc_file_write
+ *
+ * SYNOPSIS
+ *
+ *    int silc_file_write(int fd, const char *buffer, SilcUInt32 len);
+ *
+ * DESCRIPTION
+ *
+ *    Writes `buffer' of length of `len' to file descriptor `fd'.
+ *
+ ***/
 int silc_file_write(int fd, const char *buffer, SilcUInt32 len);
+
+/****f* silcutil/SilcFileUtilAPI/silc_file_close
+ *
+ * SYNOPSIS
+ *
+ *    int silc_file_close(int fd);
+ *
+ * DESCRIPTION
+ *
+ *    Closes file descriptor previously opened with silc_file_open().
+ *
+ ***/
 int silc_file_close(int fd);
+
+/****f* silcutil/SilcFileUtilAPI/silc_file_set_nonblock
+ *
+ * SYNOPSIS
+ *
+ *    int silc_file_set_nonblock(int fd);
+ *
+ * DESCRIPTION
+ *
+ *    Sets the file descriptor to non-blocking mode.
+ *
+ ***/
+int silc_file_set_nonblock(int fd);
+
+/****f* silcutil/SilcFileUtilAPI/silc_file_readfile
+ *
+ * SYNOPSIS
+ *
+ *    char *silc_file_readfile(const char *filename, SilcUInt32 *return_len);
+ *
+ * DESCRIPTION
+ *
+ *    Reads the content of `filename' to a buffer.  The allocated buffer is
+ *    returned.  This does not NULL terminate the buffer but EOF terminate
+ *    it.  The caller must replace the EOF with NULL if the buffer must be
+ *    NULL terminated.
+ *
+ *    If the `return_len' pointer is not NULL, it's filled with the length of
+ *    the file.
+ *
+ ***/
 char *silc_file_readfile(const char *filename, SilcUInt32 *return_len);
-int silc_file_writefile(const char *filename, const char *buffer, SilcUInt32 len);
-int silc_file_writefile_mode(const char *filename, const char *buffer, 
+
+/****f* silcutil/SilcFileUtilAPI/silc_file_writefile
+ *
+ * SYNOPSIS
+ *
+ *    int silc_file_writefile(const char *filename, const char *buffer,
+ *                            SilcUInt32 len);
+ *
+ * DESCRIPTION
+ *
+ *    Writes a buffer to the file.  If the file is created specific mode is
+ *    set to the file.
+ *
+ ***/
+int silc_file_writefile(const char *filename, const char *buffer,
+			SilcUInt32 len);
+
+/****f* silcutil/SilcFileUtilAPI/silc_file_writefile_mode
+ *
+ * SYNOPSIS
+ *
+ *    int silc_file_writefile_mode(const char *filename, const char *buffer,
+ *                                 SilcUInt32 len, int mode);
+ *
+ * DESCRIPTION
+ *
+ *    Writes a buffer to the file.  If the file is created the specified `mode'
+ *    is set to the file.
+ *
+ ***/
+int silc_file_writefile_mode(const char *filename, const char *buffer,
 			     SilcUInt32 len, int mode);
+
+/****f* silcutil/SilcFileUtilAPI/silc_file_size
+ *
+ * SYNOPSIS
+ *
+ *    SilcUInt64 silc_file_size(const char *filename);
+ *
+ * DESCRIPTION
+ *
+ *    Returns the size of `filename'. Returns 0 on error.
+ *
+ ***/
 SilcUInt64 silc_file_size(const char *filename);
 
-#endif /* SILCFILEUTIL_H */
+#endif	/* !SILCFILEUTIL_H */