path: root/usr/src/cmd/svr4pkg/libinst/copyf.c

/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License (the "License").
 * You may not use this file except in compliance with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */

/*
 * Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */

/* Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T */
/* All Rights Reserved */



#include <stdio.h>
#include <string.h>
#include <errno.h>
#include <stdlib.h>
#include <unistd.h>
#include <libgen.h>
#include <fcntl.h>
#include <sys/types.h>
#include <utime.h>
#include <sys/stat.h>
#include <locale.h>
#include <libintl.h>
#include <sys/mman.h>

/*
 * consolidation pkg command library includes
 */

#include "pkglib.h"

/*
 * local pkg command library includes
 */
#include "libinst.h"
#include "libadm.h"
#include "messages.h"

/*
 * MAXMAPSIZE controls the largest mapping to use at a time; please refer
 * to mmap(2) for details of how this size is incremented and rounded; briefly
 * each mapping request has an additional 16Kb added to it - mappings over
 * 4Mb will be rounded to a 4Mb boundary - thus if there were 8mb, adding
 * in the 16Kb overhead the mapping would use another 4Mb-16kb - that is
 * why there is 16Kb subtracted from the total
 */

#define	MAXMAPSIZE	(1024*1024*8)-(1024*16)	/* map at most 8MB */
#define	SMALLFILESIZE	(32*1024)	/* dont mmap files less than 32kb */

/*
 * Name:	copyF
 * Description:	fast copy of file - use mmap()/write() loop if possible
 * Arguments:	char *srcPath - name of source file to copy from
 *		char *dstPath - name of target file to copy to
 *		time_t a_mytime: control setting of access/modification times:
 *			== 0 - replicate source file access/modification times
 *			!= 0 - use specified time for access/modification times
 * Returns:	int
 *		== 0 - successful
 *		!= 0 - failure
 */

int
copyf(char *a_srcPath, char *a_dstPath, time_t a_mytime)
{
	struct stat	srcStatbuf;
	struct utimbuf	times;
	int		srcFd;
	int		dstFd;
	int		status;
	char		*pt;

	/* open source file for reading */

	srcFd = open(a_srcPath, O_RDONLY, 0);
	if (srcFd < 0) {
		progerr(ERR_OPEN_READ, a_srcPath, errno, strerror(errno));
		return (-1);
	}

	/* obtain file status of source file */

	if (fstat(srcFd, &srcStatbuf) != 0) {
		progerr(ERR_FSTAT, srcFd, a_srcPath, errno, strerror(errno));
		(void) close(srcFd);
		return (-1);
	}

	/* open target file for writing */

	dstFd = open(a_dstPath, O_WRONLY | O_TRUNC | O_CREAT,
		srcStatbuf.st_mode);
	if (dstFd < 0) {
		/* create directory structure if missing */
		pt = a_dstPath;
		while (pt = strchr(pt+1, '/')) {
			*pt = '\0';
			if (isdir(a_dstPath)) {
				if (mkdir(a_dstPath, 0755)) {
					progerr(ERR_NODIR, a_dstPath,
						errno, strerror(errno));
					*pt = '/';
					(void) close(srcFd);
					return (-1);
				}
			}
			*pt = '/';
		}

		/* attempt to create target file again */
		dstFd = open(a_dstPath, O_WRONLY | O_TRUNC | O_CREAT,
				srcStatbuf.st_mode);
		if (dstFd < 0) {
			progerr(ERR_OPEN_WRITE, a_dstPath, errno,
							strerror(errno));
			(void) close(srcFd);
			return (-1);
		}
	}

	/*
	 * source and target files are open: copy data
	 */

	status = copyFile(srcFd, dstFd, a_srcPath, a_dstPath, &srcStatbuf, 0);

	(void) close(srcFd);
	(void) close(dstFd);

	/*
	 * determine how to set access/modification times for target:
	 * -- a_mytime == 0: replicate source file access/modification times
	 * -- otherwise: use a_mytime for file access/modification times
	 */

	if (a_mytime == 0) {
		times.actime = srcStatbuf.st_atime;
		times.modtime = srcStatbuf.st_mtime;
	} else {
		times.actime = a_mytime;
		times.modtime = a_mytime;
	}

	/* set access/modification times for target */

	if (utime(a_dstPath, &times) != 0) {
		progerr(ERR_MODTIM, a_dstPath, errno, strerror(errno));
		return (-1);
	}

	/* return error if copy failed */

	if (status != 0) {
		progerr(ERR_READ, a_srcPath, errno, strerror(errno));
		return (-1);
	}

	/* success! */

	return (0);
}

/*
 * Name:	copyFile
 * Description:	fast copy of file - use mmap()/write() loop if possible
 * Arguments:	int srcFd - file descriptor open on source file
 *		int dstFd - file descriptor open on target file
 *		char *srcPath - name of source file (for error messages)
 *		char *dstPath - name of target file (for error messages)
 *		struct stat *a_srcStatbuf - stat structure for source file
 *		long a_iosize - preferred io size for read/write loop
 * Returns:	int
 *		== 0 - successful
 *		!= 0 - failure
 */

int
copyFile(int a_srcFd, int a_dstFd, char *a_srcPath, char *a_dstPath,
	struct stat *a_srcStatbuf, long a_iosize)
{
	caddr_t	cp;
	off_t	filesize = a_srcStatbuf->st_size;
	size_t	mapsize = 0;
	size_t	munmapsize = 0;
	off_t	offset = 0;

	echoDebug(DBG_COPY_FILE, a_srcPath, a_dstPath);

	/*
	 * if the source is a regular file and is not "too small", then cause
	 * the file to be mapped into memory
	 */

	if (S_ISREG(a_srcStatbuf->st_mode) && (filesize > SMALLFILESIZE)) {
		/*
		 * Determine size of initial mapping.  This will determine the
		 * size of the address space chunk we work with.  This initial
		 * mapping size will be used to perform munmap() in the future.
		 */

		mapsize = MAXMAPSIZE;
		if (filesize < mapsize) {
			mapsize = filesize;
		}

		/*
		 * remember size of mapping to "unmap" - if the source file
		 * exceeds MAXMAPSIZE bytes, then the final mapping of the
		 * source file will be less than MAXMAPSIZE, and we need to
		 * make sure that the entire mapping is unmapped when done.
		 */

		munmapsize = mapsize;

		/* map the first segment of the source into memory */

		cp = mmap((caddr_t)NULL, mapsize, PROT_READ,
			(MAP_SHARED|MAP_ALIGN), a_srcFd, (off_t)0);
		if (cp == MAP_FAILED) {
			mapsize = 0;   /* can't mmap today */
		}
	}

	/*
	 * if the source was not mapped into memory, copy via read/write loop
	 */

	if (mapsize == 0) {
		char	*buf = (char *)NULL;
		size_t	blocksize;
		int	pagesize = getpagesize();

		/* set blocksize for copy */

		blocksize = a_iosize;
		if ((blocksize == 0) || (blocksize > SMALLFILESIZE)) {
			blocksize = SMALLFILESIZE;
		} else if (blocksize < pagesize) {
			blocksize = pagesize;
		}

		/* allocate i/o transfer buffer */

		buf = memalign((size_t)pagesize, blocksize);
		if (buf == (char *)NULL) {
			progerr(ERR_COPY_MEMORY, a_srcPath, errno,
				strerror(errno));
			return (1);
		}

		/* copy the file contents */

		for (;;) {
			ssize_t	n;

			/* read next block of data */

			n = read(a_srcFd, buf, blocksize);
			if (n == 0) {
				/* end of file - return success */
				(void) free(buf);
				return (0);
			} else if (n < 0) {
				/* read error - return error */
				progerr(ERR_READ, a_srcPath,
						errno, strerror(errno));
				(void) free(buf);
				return (1);
			}

			/* write out block of data just read in */

			if (vfpSafeWrite(a_dstFd, buf, (size_t)n) != n) {
				/* short write/write error - return error */
				progerr(ERR_WRITE, a_dstPath,
						errno, strerror(errno));
				(void) free(buf);
				return (1);
			}
		}
	}

	/*
	 * the source has been mapped into memory, copy via mappings
	 */

	for (;;) {
		ssize_t	nbytes;

		/* write first mappings worth of data */

		nbytes = write(a_dstFd, cp, mapsize);

		/*
		 * if we write less than the mmaped size it's due to a
		 * media error on the input file or out of space on
		 * the output file.  So, try again, and look for errno.
		 */

		if ((nbytes >= 0) && (nbytes != (ssize_t)mapsize)) {
			size_t	remains;

			remains = mapsize - nbytes;
			while (remains > 0) {
				nbytes = write(a_dstFd,
					(cp + mapsize - remains), remains);
				if (nbytes >= 0) {
					remains -= nbytes;
					if (remains == 0) {
						nbytes = mapsize;
					}
					continue;
				}

				/* i/o error - report and exit */

				if (errno == ENOSPC) {
					progerr(ERR_WRITE, a_dstPath,
						errno, strerror(errno));
				} else {
					progerr(ERR_READ, a_srcPath,
						errno, strerror(errno));
				}

				/* unmap source file mapping */
				(void) munmap(cp, munmapsize);
				return (1);
			}
		}

		/*
		 * although the write manual page doesn't specify this
		 * as a possible errno, it is set when the nfs read
		 * via the mmap'ed file is accessed, so report the
		 * problem as a source access problem, not a target file
		 * problem
		 */

		if (nbytes < 0) {
			if (errno == EACCES) {
				progerr(ERR_READ, a_srcPath,
					errno, strerror(errno));
			} else {
				progerr(ERR_WRITE, a_dstPath,
					errno, strerror(errno));
			}

			/* unmap source file mapping */
			(void) munmap(cp, munmapsize);
			return (1);
		}

		filesize -= nbytes;
		if (filesize == 0) {
			break;
		}

		offset += nbytes;
		if (filesize < mapsize) {
			mapsize = filesize;
		}

		/* map next segment of file on top of existing mapping */

		cp = mmap(cp, mapsize, PROT_READ, (MAP_SHARED|MAP_FIXED),
			a_srcFd, offset);

		if (cp == MAP_FAILED) {
			progerr(ERR_MAPFAILED, a_srcPath, errno,
						strerror(errno));
			/* unmap source file mapping */
			(void) munmap(cp, munmapsize);
			return (1);
		}
	}

	/* unmap source file mapping */

	(void) munmap(cp, munmapsize);

	return (0);
}

/*
 * Name:	openLocal
 * Description:	open a file and assure that the descriptor returned is open on
 *		a file that is local to the current system - if the file is not
 *		local to this system, copy the file to a temporary file first,
 *		and then pass a handle back opened on the temporary file
 * Arguments:	a_path - [RO, *RO] - (char *)
 *			Pointer to string representing the path to the file
 *			to open
 *		a_oflag - [RO, *RO] - (int)
 *			Integer representing the "mode" bits for an open(2) call
 *		a_tmpdir - [RO, *RO] - (char *)
 *			Pointer to string representing the path to a directory
 *			where a temporary copy of the file can be placed if
 *			the source file is not local to this system. If this is
 *			NULL or does not exist, P_tmpdir is used.
 * Returns:	int
 *			>= 0 - file descriptor opened on the file
 *			== -1 - failed to open - errno contains error code
 * NOTE:	If the file is not local and is copied locally, the file is
 *		setup in such a way that it will be removed when the last
 *		file descriptor opened on the file is closed - there is no need
 *		to know the path to the temporary file or to remove it
 *		when done.
 */

int
openLocal(char *a_path, int a_oflag, char *a_tmpdir)
{
	char		*bn;
	char		template[PATH_MAX];
	int		fd;
	int		lerrno;
	int		n;
	int		tmpFd;
	struct stat	statbuf;

	/* open source file */

	fd = open(a_path, a_oflag);
	if (fd < 0) {
		return (fd);
	}

	/* return open fd if the source file is not remote */

	if (!isFdRemote(fd)) {
		return (fd);
	}

	/*
	 * source file is remote - must make a local copy
	 */

	/* get the source file's status */

	n = fstat(fd, &statbuf);
	if (n < 0) {
		lerrno = errno;
		(void) close(fd);
		errno = lerrno;
		return (-1);
	}

	/* generate unique temporary file name */

	if ((a_tmpdir == (char *)NULL) || (*a_tmpdir == '\0') ||
		(isdir(a_tmpdir) != 0)) {
		a_tmpdir = P_tmpdir;
	}
	bn = basename(a_path);
	n = strlen(a_tmpdir);
	n = snprintf(template, sizeof (template), "%s%s%sXXXXXX",
		a_tmpdir, a_tmpdir[n-1] == '/' ? "" : "/", bn);
	if (n > sizeof (template)) {
		(void) close(fd);
		return (EINVAL);
	}

	/* create the temporary file and open it */

	tmpFd = mkstemp(template);
	if (tmpFd < 0) {
		lerrno = errno;
		(void) close(fd);
		errno = lerrno;
		return (tmpFd);
	}

	/* unlink the file so when it is closed it is automatically deleted */

	(void) unlink(template);

	/* copy the source file to the temporary file */

	n = copyFile(fd, tmpFd, a_path, template, &statbuf, 0L);
	lerrno = errno;
	(void) close(fd);
	if (n != 0) {
		(void) close(tmpFd);
		errno = lerrno;
		return (-1);
	}

	/* return handle to temporary file created */

	return (tmpFd);
}