common/openutil.h

/*
 * Copyright (c) 2000-2001 Silicon Graphics, Inc.
 * All Rights Reserved.
 *
 * 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.
 *
 * This program is distributed in the hope that it would 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 the Free Software Foundation,
 * Inc.,  51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */
#ifndef OPENUTIL_H
#define OPENUTIL_H

/* openutil.[hc] - useful functions for opening tmp and housekeeping
 * files.
 */


/* allocate and fill a character sting buffer with a pathname generated
 * by catenating the dir and base args. if pid is non-zero, the decimal
 * representation of the pid will be appended to the pathname, beginning
 * with a '.'.
 */
extern char *open_pathalloc( char *dirname, char *basename, pid_t pid );

/* create the specified file, creating or truncating as necessary,
 * with read and write permissions, given a directory and base.
 * return the file descriptor, or -1 with errno set. uses mlog( MLOG_NORMAL...
 * if the creation fails.
 */
extern int open_trwdb( char *dirname, char *basename, pid_t pid );
extern int open_trwp( char *pathname );


/* open the specified file, with read and write permissions, given a
 * directory and base.* return the file descriptor, or -1 with errno set.
 * uses mlog( MLOG_NORMAL... if the open fails.
 */
extern int open_rwdb( char *dirname, char *basename, pid_t pid );
extern int open_rwp( char *pathname );


/* create and open the specified file, failing if already exists
 */
extern int open_erwp( char *pathname );
extern int open_erwdb( char *dirname, char *basename, pid_t pid );


/* create the specified directory, guaranteed to be initially empty. returns
 * 0 on success, -1 if trouble. uses mlog( MLOG_NORMAL... if the creation fails.
 */
extern int mkdir_tp( char *pathname );


#endif /* UTIL_H */