[BACK]Return to t_pidfile.c CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / tests / lib / libutil

File: [cvs.NetBSD.org] / src / tests / lib / libutil / t_pidfile.c (download)

Revision 1.3, Tue Mar 29 13:55:37 2011 UTC (10 years ago) by jmmv
Branch: MAIN
CVS Tags: yamt-pagecache-tag8, yamt-pagecache-base9, yamt-pagecache-base8, yamt-pagecache-base7, yamt-pagecache-base6, yamt-pagecache-base5, yamt-pagecache-base4, yamt-pagecache-base3, yamt-pagecache-base2, yamt-pagecache-base, yamt-pagecache, tls-maxphys-base, tls-maxphys, tls-earlyentropy-base, tls-earlyentropy, riastradh-xf86-video-intel-2-7-1-pre-2-21-15, riastradh-drm2-base3, riastradh-drm2-base2, riastradh-drm2-base1, riastradh-drm2-base, riastradh-drm2, prg-localcount2-base3, prg-localcount2-base2, prg-localcount2-base1, prg-localcount2-base, prg-localcount2, phil-wifi-base, phil-wifi-20200421, phil-wifi-20200411, phil-wifi-20200406, phil-wifi-20191119, phil-wifi-20190609, phil-wifi, pgoyette-localcount-base, pgoyette-localcount-20170426, pgoyette-localcount-20170320, pgoyette-localcount-20170107, pgoyette-localcount-20161104, pgoyette-localcount-20160806, pgoyette-localcount-20160726, pgoyette-localcount, pgoyette-compat-merge-20190127, pgoyette-compat-base, pgoyette-compat-20190127, pgoyette-compat-20190118, pgoyette-compat-1226, pgoyette-compat-1126, pgoyette-compat-1020, pgoyette-compat-0930, pgoyette-compat-0906, pgoyette-compat-0728, pgoyette-compat-0625, pgoyette-compat-0521, pgoyette-compat-0502, pgoyette-compat-0422, pgoyette-compat-0415, pgoyette-compat-0407, pgoyette-compat-0330, pgoyette-compat-0322, pgoyette-compat-0315, pgoyette-compat, perseant-stdc-iso10646-base, perseant-stdc-iso10646, netbsd-9-base, netbsd-9-1-RELEASE, netbsd-9-0-RELEASE, netbsd-9-0-RC2, netbsd-9-0-RC1, netbsd-9, netbsd-8-base, netbsd-8-2-RELEASE, netbsd-8-1-RELEASE, netbsd-8-1-RC1, netbsd-8-0-RELEASE, netbsd-8-0-RC2, netbsd-8-0-RC1, netbsd-8, netbsd-7-nhusb-base-20170116, netbsd-7-nhusb-base, netbsd-7-nhusb, netbsd-7-base, netbsd-7-2-RELEASE, netbsd-7-1-RELEASE, netbsd-7-1-RC2, netbsd-7-1-RC1, netbsd-7-1-2-RELEASE, netbsd-7-1-1-RELEASE, netbsd-7-1, netbsd-7-0-RELEASE, netbsd-7-0-RC3, netbsd-7-0-RC2, netbsd-7-0-RC1, netbsd-7-0-2-RELEASE, netbsd-7-0-1-RELEASE, netbsd-7-0, netbsd-7, netbsd-6-base, netbsd-6-1-RELEASE, netbsd-6-1-RC4, netbsd-6-1-RC3, netbsd-6-1-RC2, netbsd-6-1-RC1, netbsd-6-1-5-RELEASE, netbsd-6-1-4-RELEASE, netbsd-6-1-3-RELEASE, netbsd-6-1-2-RELEASE, netbsd-6-1-1-RELEASE, netbsd-6-1, netbsd-6-0-RELEASE, netbsd-6-0-RC2, netbsd-6-0-RC1, netbsd-6-0-6-RELEASE, netbsd-6-0-5-RELEASE, netbsd-6-0-4-RELEASE, netbsd-6-0-3-RELEASE, netbsd-6-0-2-RELEASE, netbsd-6-0-1-RELEASE, netbsd-6-0, netbsd-6, matt-nb8-mediatek-base, matt-nb8-mediatek, matt-nb6-plus-nbase, matt-nb6-plus-base, matt-nb6-plus, localcount-20160914, is-mlppp-base, is-mlppp, cherry-xenmp-base, cherry-xenmp, bouyer-socketcan-base1, bouyer-socketcan-base, bouyer-socketcan, agc-symver-base, agc-symver, HEAD
Changes since 1.2: +111 -8 lines

Extend pidfile(3) to support creating pid files in arbitrary locations.

If the argument provided to pidfile(3) contains a '/', then the value is
considered to be an absolute/relative path and the pid file is created
in the given location.

Otherwise, pidfile(3) behaves as before and treats the provided value as
a basename to construct a pid file in /var/run/<basename>.pid.  This means
that to create a pid file named "foo.pid" in the current directory, one
must specify "./foo.pid".

/* $NetBSD: t_pidfile.c,v 1.3 2011/03/29 13:55:37 jmmv Exp $ */

/*
 * Copyright (c) 2011 The NetBSD Foundation, Inc.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

/*
 * This file implements tests for the pidfile(3) functions.
 *
 * The tests here are tricky because we need to validate that the atexit(3)
 * handler registered by pidfile(3) correctly deletes the generated pidfile.
 * To do so:
 * 1) We spawn a subprocess in every test case,
 * 2) Run our test code in such subprocesses.  We cannot call any of the ATF
 *    primitives from inside these.
 * 3) Wait for the subprocess to terminate and ensure it exited successfully.
 * 4) Check that the pidfile(s) created in the subprocess are gone.
 *
 * Additionally, pidfile(3) hardcodes a path to a directory writable only by
 * root (/var/run).  This makes us require root privileges to execute these
 * tests.
 */

#include <sys/cdefs.h>
__COPYRIGHT("@(#) Copyright (c) 2011\
 The NetBSD Foundation, inc. All rights reserved.");
__RCSID("$NetBSD: t_pidfile.c,v 1.3 2011/03/29 13:55:37 jmmv Exp $");

#include <sys/stat.h>
#include <sys/wait.h>

#include <assert.h>
#include <err.h>
#include <stdbool.h>
#include <stdio.h>
#include <stdlib.h>
#include <paths.h>
#include <unistd.h>
#include <util.h>

#include <atf-c.h>

/* Used by routines that can be called both from the parent and the child
 * code to implement proper error reporting. */
static bool in_child = false;

/* Callable from the test case child code. */
static void
check_pidfile(const char *path)
{
	FILE *file;
	int pid;

	printf("Validating contents of pidfile '%s'\n", path);

	if ((file = fopen(path, "r")) == NULL)
		errx(EXIT_FAILURE, "Cannot open expected pidfile '%s'", path);

	if (fscanf(file, "%d", &pid) == -1)
		errx(EXIT_FAILURE, "Failed to read pid from pidfile '%s'",
		    path);

	printf("Read pid %d, current pid %d\n", pid, getpid());
	if (pid != getpid())
		errx(EXIT_FAILURE, "Pid in pidfile (%d) does not match "
		    "current pid (%d)", pid, getpid());
}

/* Callable from the test case parent/child code. */
static void
ensure_deleted(const char *path)
{
	printf("Ensuring pidfile %s does not exist any more\n", path);
	if (access(path, R_OK) != -1) {
		unlink(path);
		if (in_child)
			errx(EXIT_FAILURE, "The pidfile %s was not deleted",
			    path);
		else
			atf_tc_fail("The pidfile %s was not deleted", path);
	}
}

/* Callable from the test case parent code. */
static void
run_child(void (*child)(const char *), const char *cookie)
{
	pid_t pid;

	pid = fork();
	ATF_REQUIRE(pid != -1);
	if (pid == 0) {
		in_child = true;
		child(cookie);
		assert(false);
		/* UNREACHABLE */
	} else {
		int status;

		ATF_REQUIRE(waitpid(pid, &status, 0) != -1);
		if (!WIFEXITED(status) || WEXITSTATUS(status) != EXIT_SUCCESS)
			atf_tc_fail("See stderr for details");
	}
}

/* Callable from the test case parent/child code. */
static char *
generate_varrun_pidfile(const char *basename)
{
	char *path;

	if (asprintf(&path, "%s%s.pid", _PATH_VARRUN,
	    basename == NULL ? getprogname() : basename) == -1) {
		if (in_child)
			errx(EXIT_FAILURE, "Cannot allocate memory for path");
		else
			atf_tc_fail("Cannot allocate memory for path");
	}

	return path;
}

static void
helper_default_path(const char *path)
{

	if (pidfile(NULL) == -1)
		errx(EXIT_FAILURE, "Failed to create pidfile with default "
		    "basename");

	check_pidfile(path);
	exit(EXIT_SUCCESS);
}

ATF_TC(default_path);
ATF_TC_HEAD(default_path, tc)
{
	atf_tc_set_md_var(tc, "require.user", "root");
}
ATF_TC_BODY(default_path, tc)
{
	char *path;

	path = generate_varrun_pidfile(NULL);
	run_child(helper_default_path, path);
	ensure_deleted(path);
	free(path);
}

static void
helper_custom_basename(const char *path)
{

	if (pidfile("custom-basename") == -1)
		errx(EXIT_FAILURE, "Failed to create pidfile with custom "
		    "basename");

	check_pidfile(path);
	exit(EXIT_SUCCESS);
}

ATF_TC(custom_basename);
ATF_TC_HEAD(custom_basename, tc)
{
	atf_tc_set_md_var(tc, "require.user", "root");
}
ATF_TC_BODY(custom_basename, tc)
{
	char *path;

	path = generate_varrun_pidfile("custom-basename");
	run_child(helper_custom_basename, path);
	ensure_deleted(path);
	free(path);
}

static void
helper_custom_path(const char *path)
{

	if (pidfile(path) == -1)
		errx(EXIT_FAILURE, "Failed to create pidfile '%s'", path);
	check_pidfile(path);
	exit(EXIT_SUCCESS);
}

ATF_TC_WITHOUT_HEAD(custom_path);
ATF_TC_BODY(custom_path, tc)
{

	ATF_REQUIRE(mkdir("var", 0777) != -1);
	ATF_REQUIRE(mkdir("var/run", 0777) != -1);

	run_child(helper_custom_path, "./var/run/my-pidfile.pid");

	ensure_deleted("./var/run/my-pidfile.pid");
}

static void
helper_change_basenames(const char *unused_cookie)
{
	char *default_path;
	char *custom_path;

	default_path = generate_varrun_pidfile(NULL);
	if (pidfile(NULL) == -1)
		errx(EXIT_FAILURE, "Failed to create pidfile with default "
		    "basename");
	check_pidfile(default_path);
	if (pidfile(NULL) == -1)
		errx(EXIT_FAILURE, "Failed to recreate pidfile with default "
		    "basename");
	check_pidfile(default_path);

	custom_path = generate_varrun_pidfile("custom-basename");
	if (pidfile("custom-basename") == -1)
		errx(EXIT_FAILURE, "Failed to create pidfile with custom "
		    "basename");
	ensure_deleted(default_path);
	check_pidfile(custom_path);
	if (pidfile("custom-basename") == -1)
		errx(EXIT_FAILURE, "Failed to recreate pidfile with custom "
		    "basename");
	check_pidfile(custom_path);

	free(custom_path);
	free(default_path);
	exit(EXIT_SUCCESS);
}

ATF_TC(change_basenames);
ATF_TC_HEAD(change_basenames, tc)
{
	atf_tc_set_md_var(tc, "require.user", "root");
}
ATF_TC_BODY(change_basenames, tc)
{
	char *default_path;
	char *custom_path;

	run_child(helper_change_basenames, NULL);

	default_path = generate_varrun_pidfile(NULL);
	custom_path = generate_varrun_pidfile("custom-basename");

	ensure_deleted(default_path);
	ensure_deleted(custom_path);

	free(custom_path);
	free(default_path);
}

static void
helper_change_paths(const char *unused_cookie)
{

	if (pidfile("./var/run/first.pid") == -1)
		errx(EXIT_FAILURE, "Failed to create pidfile "
		    "'./var/run/first.pid'");
	check_pidfile("./var/run/first.pid");

	if (pidfile("./second.pid") == -1)
		errx(EXIT_FAILURE, "Failed to create pidfile 'second.pid'");
	ensure_deleted("./var/run/first.pid");
	check_pidfile("./second.pid");

	exit(EXIT_SUCCESS);
}

ATF_TC_WITHOUT_HEAD(change_paths);
ATF_TC_BODY(change_paths, tc)
{

	ATF_REQUIRE(mkdir("var", 0777) != -1);
	ATF_REQUIRE(mkdir("var/run", 0777) != -1);

	run_child(helper_change_paths, NULL);

	ensure_deleted("./var/run/my-pidfile.pid");
	ensure_deleted("second.pid");
}

static void
helper_mix(const char *unused_cookie)
{
	char *default_path;
	char *custom_path;

	default_path = generate_varrun_pidfile(NULL);
	custom_path = generate_varrun_pidfile("custom-basename");

	if (pidfile(NULL) == -1)
		errx(EXIT_FAILURE, "Failed to create default pidfile");
	check_pidfile(default_path);

	if (pidfile("./second.pid") == -1)
		errx(EXIT_FAILURE, "Failed to create pidfile 'second.pid'");
	ensure_deleted(default_path);
	check_pidfile("./second.pid");

	if (pidfile("custom-basename") == -1)
		errx(EXIT_FAILURE, "Failed to create pidfile 'second.pid'");
	ensure_deleted(default_path);
	ensure_deleted("./second.pid");
	ensure_deleted("./custom-basename");
	check_pidfile(custom_path);

	free(custom_path);
	free(default_path);
	exit(EXIT_SUCCESS);
}

ATF_TC(change_mix);
ATF_TC_HEAD(change_mix, tc)
{
	atf_tc_set_md_var(tc, "require.user", "root");
}
ATF_TC_BODY(change_mix, tc)
{
	char *default_path;

	run_child(helper_mix, NULL);

	default_path = generate_varrun_pidfile(NULL);
	ensure_deleted(default_path);
	ensure_deleted("second.pid");
	free(default_path);
}

ATF_TP_ADD_TCS(tp)
{

	ATF_TP_ADD_TC(tp, default_path);
	ATF_TP_ADD_TC(tp, custom_basename);
	ATF_TP_ADD_TC(tp, custom_path);
	ATF_TP_ADD_TC(tp, change_basenames);
	ATF_TP_ADD_TC(tp, change_paths);
	ATF_TP_ADD_TC(tp, change_mix);

	return atf_no_error();
}