dpkg/lib/dpkg/path.c

/*
 * libdpkg - Debian packaging suite library routines
 * path.c - path handling functions
 *
 * Copyright © 1995 Ian Jackson <ian@chiark.greenend.org.uk>
 * Copyright © 2008, 2009 Guillem Jover <guillem@debian.org>
 *
 * This 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; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This is distributed in the hope that it will 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, see <http://www.gnu.org/licenses/>.
 */

#include <config.h>
#include <compat.h>

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <stdio.h>

#include <dpkg/varbuf.h>
#include <dpkg/path.h>

size_t
path_rtrim_slash_slashdot(char *path)
{
	char *end;

	if (!path || !*path)
		return 0;

	for (end = path + strlen(path) - 1; end - path >= 1; end--) {
		if (*end == '/' || (*(end - 1) == '/' && *end == '.'))
			*end = '\0';
		else
			break;
	}

	return end - path + 1;
}

const char *
path_skip_slash_dotslash(const char *path)
{
	while (path[0] == '/' || (path[0] == '.' && path[1] == '/'))
		path++;

	return path;
}

/**
 * Create a template for a temporary pathname.
 *
 * @param suffix The suffix to use for the template string.
 *
 * @return An allocated string with the created template.
 */
char *
path_make_temp_template(const char *suffix)
{
	const char *tmpdir;
	struct varbuf template = VARBUF_INIT;

	tmpdir = getenv("TMPDIR");
#ifdef P_tmpdir
	if (!tmpdir)
		tmpdir = P_tmpdir;
#endif
	if (!tmpdir)
		tmpdir = "/tmp";

	varbufprintf(&template, "%s/%s.XXXXXX", tmpdir, suffix);

	return varbuf_detach(&template);
}

/*
 * snprintf(3) doesn't work if format contains %.<nnn>s and an argument has
 * invalid char for locale, then it returns -1.
 * ohshite() is ok, but fd_fd_copy(), which is used in tarobject(), is not
 * ok, because:
 *
 * - fd_fd_copy() == buffer_copy_TYPE() ‘lib/dpkg/buffer.h’.
 * - buffer_copy_TYPE() uses varbufvprintf(&v, desc, al); ‘lib/dpkg/buffer.c’.
 * - varbufvprintf() fails, because it calls with:
 *     fmt = "backend dpkg-deb during '%.255s'"
 *   arg may contain some invalid char, for example,
 *   «/usr/share/doc/console-tools/examples/unicode/\342\231\252\342\231\254»
 *   in console-tools.
 *
 * In this case, if the user uses some locale which doesn't support
 * “\342\231...”, vsnprintf() always returns -1 and varbufextend() fails.
 *
 * So, we need to escape invalid char, probably as in
 * ‘tar-1.13.19/lib/quotearg.c: quotearg_buffer_restyled()’
 * but here we escape all 8 bit chars, in order make it simple.
 */
char *
path_quote_filename(char *dst, const char *src, size_t size)
{
	char *r = dst;

	while (size > 0) {
		switch (*src) {
		case '\0':
			*dst = '\0';
			return r;
		case '\\':
			*dst++ = '\\';
			*dst++ = '\\';
			size -= 2;
			break;
		default:
			if (((*src) & 0x80) == '\0') {
				*dst++ = *src++;
				--size;
			} else {
				if (size > 4) {
					sprintf(dst, "\\%03o",
					        *(const unsigned char *)src);
					size -= 4;
					dst += 4;
					src++;
				} else {
					/* Buffer full. */
					*dst = '\0'; /* XXX */
					return r;
				}
			}
		}
	}
	*dst = '\0'; /* XXX */

	return r;
}