/* tag: Tom Lord Tue Dec  4 14:41:40 2001 (safe-vu-utils.c)
 */
/* safe-vu-utils.c -
 *
 ****************************************************************
 * Copyright (C) 2000 Tom Lord
 * 
 * See the file "COPYING" for further information about
 * the copyright and warranty status of this work.
 */


#include "hackerlab/os/errno-to-string.h"
#include "hackerlab/bugs/panic.h"
#include "hackerlab/vu/printfmt.h"
#include "hackerlab/vu/safe-vu-utils.h"




/*(c safe_move_fd)
 * int safe_move_fd (int fd, int newfd);
 * 
 * See xref:"move_fd".
 */
int
safe_move_fd (int fd, int newfd)
{
  int errn;
  int answer;

  answer = vu_move_fd (&errn, fd, newfd);
  if (0 > answer)
    {
      printfmt (&errn, 2, "Error calling `vu_move_fd' to move descriptor %d to descriptor %d (%s)\n", fd, newfd, errno_to_string (errn));
      panic ("I/O error");
    }
  return answer;
}


/*(c safe_file_to_string)
 * int safe_file_to_string (t_uchar ** buf,
 *                          size_t * len,
 *                          int fd);
 * 
 * Read the entire contents of `fd' into a newly allocated string.
 * 
 * The new string is returned in `*buf'; its length in `*len'.
 * 
 * If `vu_fstat' is able to report the length of the file, a single call to 
 * `vu_read_retry' is used to read its contents.  Otherwise, repeated calls
 * to `vu_read_retry' are used.
 */
void
safe_file_to_string (t_uchar ** buf, size_t * len, int fd)
{
  int errn;
  int answer;

  answer = vu_file_to_string (&errn, buf, len, fd);
  if (0 > answer)
    {
      printfmt (&errn, 2, "Error calling `vu_file_to_string' for descriptor %d (%s)\n", fd, errno_to_string (errn));
      panic ("I/O error");
    }
}


/*(c safe_file_is_directory)
 * int safe_file_is_directory (t_uchar * name);
 * 
 * Return 1 if `name' names a directory, 0 if not.
 * 
 * (If `name' is a symbolic link, even to a directory, 0 is 
 * returned, but see also xref:"safe_file_is_directory_following".)
 * 
 * Non-existence of any file called `name' is not an error.
 */
int
safe_file_is_directory (t_uchar const * const name)
{
  int errn;
  int answer;

  answer = vu_file_is_directory (&errn, (t_uchar *)name);

  if (0 > answer)
    {
      printfmt (&errn, 2, "Error calling `vu_file_is_directory' (%s)\n", errno_to_string (errn));
      printfmt (&errn, 2, "  file %s\n", name);
      panic ("I/O error");
    }
  return answer;
}


/*(c safe_file_is_directory_following)
 * int safe_file_is_directory_following (t_uchar * name);
 * 
 * Return 1 if `name' names a directory or symlink to a directory, 
 * 0 if not.
 * 
 * Non-existence of any file called `name' is not an error.
 */
int
safe_file_is_directory_following (t_uchar const * const name)
{
  int errn;
  int answer;

  answer = vu_file_is_directory_following (&errn, (t_uchar *)name);

  if (0 > answer)
    {
      printfmt (&errn, 2, "Error calling `vu_file_is_directory_following' (%s)\n", errno_to_string (errn));
      printfmt (&errn, 2, "  file %s\n", name);
      panic ("I/O error");
    }
  return answer;
}