getdelim_test.c

/*-
 * Copyright (c) 2009 David Schultz <[email protected]>
 * Copyright (c) 2021 Dell EMC
 * 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 AUTHOR 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 AUTHOR 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.
 */

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

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

#include <atf-c.h>

#define	CHUNK_MAX	10

/* The assertions depend on this string. */
char apothegm[] = "All work and no play\0 makes Jack a dull boy.\n";

/*
 * This is a neurotic reader function designed to give getdelim() a
 * hard time. It reads through the string `apothegm' and returns a
 * random number of bytes up to the requested length.
 */
static int
_reader(void *cookie, char *buf, int len)
{
	size_t *offp = cookie;
	size_t r;

	r = random() % CHUNK_MAX + 1;
	if (len > r)
		len = r;
	if (len > sizeof(apothegm) - *offp)
		len = sizeof(apothegm) - *offp;
	memcpy(buf, apothegm + *offp, len);
	*offp += len;
	return (len);
}

static FILE *
mkfilebuf(void)
{
	size_t *offp;

	offp = malloc(sizeof(*offp));	/* XXX leak */
	*offp = 0;
	return (fropen(offp, _reader));
}

ATF_TC_WITHOUT_HEAD(getline_basic);
ATF_TC_BODY(getline_basic, tc)
{
	FILE *fp;
	char *line;
	size_t linecap;
	int i;

	srandom(0);

	/*
	 * Test multiple times with different buffer sizes
	 * and different _reader() return values.
	 */
	errno = 0;
	for (i = 0; i < 8; i++) {
		fp = mkfilebuf();
		linecap = i;
		line = malloc(i);
		/* First line: the full apothegm */
		ATF_REQUIRE(getline(&line, &linecap, fp) == sizeof(apothegm) - 1);
		ATF_REQUIRE(memcmp(line, apothegm, sizeof(apothegm)) == 0);
		ATF_REQUIRE(linecap >= sizeof(apothegm));
		/* Second line: the NUL terminator following the newline */
		ATF_REQUIRE(getline(&line, &linecap, fp) == 1);
		ATF_REQUIRE(line[0] == '\0' && line[1] == '\0');
		/* Third line: EOF */
		line[0] = 'X';
		ATF_REQUIRE(getline(&line, &linecap, fp) == -1);
		ATF_REQUIRE(line[0] == '\0');
		free(line);
		line = NULL;
		ATF_REQUIRE(feof(fp));
		ATF_REQUIRE(!ferror(fp));
		fclose(fp);
	}
	ATF_REQUIRE(errno == 0);
}

ATF_TC_WITHOUT_HEAD(stream_error);
ATF_TC_BODY(stream_error, tc)
{
	char *line;
	size_t linecap;

	/* Make sure read errors are handled properly. */
	line = NULL;
	linecap = 0;
	errno = 0;
	ATF_REQUIRE(getline(&line, &linecap, stdout) == -1);
	ATF_REQUIRE(errno == EBADF);
	errno = 0;
	ATF_REQUIRE(getdelim(&line, &linecap, 'X', stdout) == -1);
	ATF_REQUIRE(errno == EBADF);
	ATF_REQUIRE(ferror(stdout));
}

ATF_TC_WITHOUT_HEAD(invalid_params);
ATF_TC_BODY(invalid_params, tc)
{
	FILE *fp;
	char *line;
	size_t linecap;

	/* Make sure NULL linep or linecapp pointers are handled. */
	fp = mkfilebuf();
	ATF_REQUIRE(getline(NULL, &linecap, fp) == -1);
	ATF_REQUIRE(errno == EINVAL);
	ATF_REQUIRE(getline(&line, NULL, fp) == -1);
	ATF_REQUIRE(errno == EINVAL);
	ATF_REQUIRE(ferror(fp));
	fclose(fp);
}

ATF_TC_WITHOUT_HEAD(eof);
ATF_TC_BODY(eof, tc)
{
	FILE *fp;
	char *line;
	size_t linecap;

	/* Make sure getline() allocates memory as needed if fp is at EOF. */
	errno = 0;
	fp = mkfilebuf();
	while (!feof(fp))	/* advance to EOF; can't fseek this stream */
		getc(fp);
	line = NULL;
	linecap = 0;
	printf("getline\n");
	ATF_REQUIRE(getline(&line, &linecap, fp) == -1);
	ATF_REQUIRE(line[0] == '\0');
	ATF_REQUIRE(linecap > 0);
	ATF_REQUIRE(errno == 0);
	printf("feof\n");
	ATF_REQUIRE(feof(fp));
	ATF_REQUIRE(!ferror(fp));
	fclose(fp);
}

ATF_TC_WITHOUT_HEAD(nul);
ATF_TC_BODY(nul, tc)
{
	FILE *fp;
	char *line;
	size_t linecap, n;

	errno = 0;
	line = NULL;
	linecap = 0;
	/* Make sure a NUL delimiter works. */
	fp = mkfilebuf();
	n = strlen(apothegm);
	printf("getdelim\n");
	ATF_REQUIRE(getdelim(&line, &linecap, '\0', fp) == n + 1);
	ATF_REQUIRE(strcmp(line, apothegm) == 0);
	ATF_REQUIRE(line[n + 1] == '\0');
	ATF_REQUIRE(linecap > n + 1);
	n = strlen(apothegm + n + 1);
	printf("getdelim 2\n");
	ATF_REQUIRE(getdelim(&line, &linecap, '\0', fp) == n + 1);
	ATF_REQUIRE(line[n + 1] == '\0');
	ATF_REQUIRE(linecap > n + 1);
	ATF_REQUIRE(errno == 0);
	ATF_REQUIRE(!ferror(fp));
	fclose(fp);
}

ATF_TC_WITHOUT_HEAD(empty_NULL_buffer);
ATF_TC_BODY(empty_NULL_buffer, tc)
{
	FILE *fp;
	char *line;
	size_t linecap;

	/* Make sure NULL *linep and zero *linecapp are handled. */
	fp = mkfilebuf();
	line = NULL;
	linecap = 42;
	ATF_REQUIRE(getline(&line, &linecap, fp) == sizeof(apothegm) - 1);
	ATF_REQUIRE(memcmp(line, apothegm, sizeof(apothegm)) == 0);
	fp = mkfilebuf();
	free(line);
	line = malloc(100);
	linecap = 0;
	ATF_REQUIRE(getline(&line, &linecap, fp) == sizeof(apothegm) - 1);
	ATF_REQUIRE(memcmp(line, apothegm, sizeof(apothegm)) == 0);
	free(line);
	ATF_REQUIRE(!ferror(fp));
	fclose(fp);
}

static void
_ipc_read(int fd, char wait_c)
{
	char c;
	ssize_t len;

	c = 0;
	while (c != wait_c) {
		len = read(fd, &c, 1);
		ATF_CHECK_MSG(len != 0,
		    "EOF on IPC pipe while waiting. Did other side fail?");
		ATF_CHECK_MSG(len == 1 || errno == EINTR,
		    "read %zu bytes errno %d\n", len, errno);
		if (len != 1 || errno != EINTR)
			break;
	}
}

static void
_ipc_write(int fd, char c)
{

	while ((write(fd, &c, 1) != 1))
		ATF_REQUIRE(errno == EINTR);
}

static void
ipc_wait(int ipcfd[2])
{

	_ipc_read(ipcfd[0], '+');
	/* Send ACK. */
	_ipc_write(ipcfd[1], '-');
}

static void
ipc_wakeup(int ipcfd[2])
{

	_ipc_write(ipcfd[1], '+');
	/* Wait for ACK. */
	_ipc_read(ipcfd[0], '-');
}

static void
_nonblock_eagain(int buf_mode)
{
	FILE *fp;
	const char delim = '!';
	const char *strs[] = {
	    "first line partial!",
	    "second line is sent in full!",
	    "third line is sent partially!",
	    "last line is sent in full!",
	};
	char *line;
	size_t linecap, strslen[nitems(strs)];
	ssize_t linelen;
	int fd_fifo, flags, i, ipcfd[2], pipedes[2], pipedes2[2], status;
	pid_t pid;

	line = NULL;
	linecap = 0;
	for (i = 0; i < nitems(strslen); i++)
		strslen[i] = strlen(strs[i]);
	ATF_REQUIRE(pipe2(pipedes, O_CLOEXEC) == 0);
	ATF_REQUIRE(pipe2(pipedes2, O_CLOEXEC) == 0);

	(void)unlink("fifo");
	ATF_REQUIRE(mkfifo("fifo", 0666) == 0);
	ATF_REQUIRE((pid = fork()) >= 0);
	if (pid == 0) {
		close(pipedes[0]);
		ipcfd[1] = pipedes[1];
		ipcfd[0] = pipedes2[0];
		close(pipedes2[1]);

		ATF_REQUIRE((fd_fifo = open("fifo", O_WRONLY)) != -1);

		/* Partial write. */
		ATF_REQUIRE(write(fd_fifo, strs[0], strslen[0] - 3) ==
		    strslen[0] - 3);
		ipc_wakeup(ipcfd);

		ipc_wait(ipcfd);
		/* Finish off the first line. */
		ATF_REQUIRE(write(fd_fifo,
		    &(strs[0][strslen[0] - 3]), 3) == 3);
		/* And include the second full line and a partial 3rd line. */
		ATF_REQUIRE(write(fd_fifo, strs[1], strslen[1]) == strslen[1]);
		ATF_REQUIRE(write(fd_fifo, strs[2], strslen[2] - 3) ==
		    strslen[2] - 3);
		ipc_wakeup(ipcfd);

		ipc_wait(ipcfd);
		/* Finish the partial write and partially send the last. */
		ATF_REQUIRE(write(fd_fifo,
		    &(strs[2][strslen[2] - 3]), 3) == 3);
		ATF_REQUIRE(write(fd_fifo, strs[3], strslen[3] - 3) ==
		    strslen[3] - 3);
		ipc_wakeup(ipcfd);

		ipc_wait(ipcfd);
		/* Finish the write */
		ATF_REQUIRE(write(fd_fifo,
		    &(strs[3][strslen[3] - 3]), 3) == 3);
		ipc_wakeup(ipcfd);
		_exit(0);
	}
	ipcfd[0] = pipedes[0];
	close(pipedes[1]);
	close(pipedes2[0]);
	ipcfd[1] = pipedes2[1];

	ATF_REQUIRE((fp = fopen("fifo", "r")) != NULL);
	setvbuf(fp, (char *)NULL, buf_mode, 0);
	ATF_REQUIRE((flags = fcntl(fileno(fp), F_GETFL, 0)) != -1);
	ATF_REQUIRE(fcntl(fileno(fp), F_SETFL, flags | O_NONBLOCK) >= 0);

	/* Wait until the writer completes its partial write. */
	ipc_wait(ipcfd);
	ATF_REQUIRE_ERRNO(EAGAIN,
	    (linelen = getdelim(&line, &linecap, delim, fp)) == -1);
	ATF_REQUIRE_STREQ("", line);
	ATF_REQUIRE(ferror(fp));
	ATF_REQUIRE(!feof(fp));
	clearerr(fp);
	ipc_wakeup(ipcfd);

	ipc_wait(ipcfd);
	/*
	 * Should now have the finished first line, a full second line,
	 * and a partial third line.
	 */
	ATF_CHECK(getdelim(&line, &linecap, delim, fp) == strslen[0]);
	ATF_REQUIRE_STREQ(strs[0], line);
	ATF_REQUIRE(getdelim(&line, &linecap, delim, fp) == strslen[1]);
	ATF_REQUIRE_STREQ(strs[1], line);

	ATF_REQUIRE_ERRNO(EAGAIN,
	    (linelen = getdelim(&line, &linecap, delim, fp)) == -1);
	ATF_REQUIRE_STREQ("", line);
	ATF_REQUIRE(ferror(fp));
	ATF_REQUIRE(!feof(fp));
	clearerr(fp);
	ipc_wakeup(ipcfd);

	/* Wait for the partial write to be completed and another to be done. */
	ipc_wait(ipcfd);
	ATF_REQUIRE((linelen = getdelim(&line, &linecap, delim, fp)) != -1);
	ATF_REQUIRE(!ferror(fp));
	ATF_REQUIRE(!feof(fp));
	ATF_REQUIRE_STREQ(strs[2], line);
	ATF_REQUIRE(linelen == strslen[2]);

	ATF_REQUIRE_ERRNO(EAGAIN,
	    (linelen = getdelim(&line, &linecap, delim, fp)) == -1);
	ATF_REQUIRE_STREQ("", line);
	ATF_REQUIRE(ferror(fp));
	ATF_REQUIRE(!feof(fp));
	clearerr(fp);
	ipc_wakeup(ipcfd);

	ipc_wait(ipcfd);
	ATF_REQUIRE((linelen = getdelim(&line, &linecap, delim, fp)) != -1);
	ATF_REQUIRE(!ferror(fp));
	ATF_REQUIRE(!feof(fp));
	ATF_REQUIRE_STREQ(strs[3], line);
	ATF_REQUIRE(linelen == strslen[3]);

	ATF_REQUIRE(waitpid(pid, &status, WEXITED) != -1);
	ATF_REQUIRE(WIFEXITED(status));
	ATF_REQUIRE(WEXITSTATUS(status) == 0);
}

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

	_nonblock_eagain(_IOFBF);
}

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

	_nonblock_eagain(_IONBF);
}


ATF_TP_ADD_TCS(tp)
{

	ATF_TP_ADD_TC(tp, getline_basic);
	ATF_TP_ADD_TC(tp, stream_error);
	ATF_TP_ADD_TC(tp, eof);
	ATF_TP_ADD_TC(tp, invalid_params);
	ATF_TP_ADD_TC(tp, nul);
	ATF_TP_ADD_TC(tp, empty_NULL_buffer);
	ATF_TP_ADD_TC(tp, nonblock_eagain_unbuffered);
	ATF_TP_ADD_TC(tp, nonblock_eagain_buffered);

	return (atf_no_error());
}