root/lib/libc/tests/nss/getpw_test.c
/*-
 * Copyright (c) 2006 Michael Bushkov <bushman@freebsd.org>
 * 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 <errno.h>
#include <pwd.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>

#include <atf-c.h>

#include "testutil.h"

enum test_methods {
        TEST_GETPWENT,
        TEST_GETPWENT_INTERLEAVED_GETPWNAM,
        TEST_GETPWENT_INTERLEAVED_GETPWUID,
        TEST_GETPWNAM,
        TEST_GETPWUID,
        TEST_GETPWENT_2PASS,
        TEST_BUILD_SNAPSHOT
};

DECLARE_TEST_DATA(passwd)
DECLARE_TEST_FILE_SNAPSHOT(passwd)
DECLARE_1PASS_TEST(passwd)
DECLARE_2PASS_TEST(passwd)

static void clone_passwd(struct passwd *, struct passwd const *);
static int compare_passwd(struct passwd *, struct passwd *, void *);
static void free_passwd(struct passwd *);

static void sdump_passwd(struct passwd *, char *, size_t);
#ifdef DEBUG
static void dump_passwd(struct passwd *);
#endif

static int passwd_read_snapshot_func(struct passwd *, char *);

static int passwd_check_ambiguity(struct passwd_test_data *, struct passwd *);
static int passwd_fill_test_data(struct passwd_test_data *,
    int (*cb)(struct passwd *, void *));
static int passwd_test_correctness(struct passwd *, void *);
static int passwd_test_getpwnam(struct passwd *, void *);
static int passwd_test_getpwuid(struct passwd *, void *);
static int passwd_test_getpwent(struct passwd *, void *);

IMPLEMENT_TEST_DATA(passwd)
IMPLEMENT_TEST_FILE_SNAPSHOT(passwd)
IMPLEMENT_1PASS_TEST(passwd)
IMPLEMENT_2PASS_TEST(passwd)

static void
clone_passwd(struct passwd *dest, struct passwd const *src)
{
        ATF_REQUIRE(dest != NULL);
        ATF_REQUIRE(src != NULL);

        memcpy(dest, src, sizeof(struct passwd));
        if (src->pw_name != NULL)
                dest->pw_name = strdup(src->pw_name);
        if (src->pw_passwd != NULL)
                dest->pw_passwd = strdup(src->pw_passwd);
        if (src->pw_class != NULL)
                dest->pw_class = strdup(src->pw_class);
        if (src->pw_gecos != NULL)
                dest->pw_gecos = strdup(src->pw_gecos);
        if (src->pw_dir != NULL)
                dest->pw_dir = strdup(src->pw_dir);
        if (src->pw_shell != NULL)
                dest->pw_shell = strdup(dest->pw_shell);
}

static int
compare_passwd(struct passwd *pwd1, struct passwd *pwd2, void *mdata __unused)
{
        ATF_REQUIRE(pwd1 != NULL);
        ATF_REQUIRE(pwd2 != NULL);

        if (pwd1 == pwd2)
                return (0);

        if (pwd1->pw_uid != pwd2->pw_uid ||
            pwd1->pw_gid != pwd2->pw_gid ||
            pwd1->pw_change != pwd2->pw_change ||
            pwd1->pw_expire != pwd2->pw_expire ||
            pwd1->pw_fields != pwd2->pw_fields ||
            strcmp(pwd1->pw_name, pwd2->pw_name) != 0 ||
            strcmp(pwd1->pw_passwd, pwd2->pw_passwd) != 0 ||
            strcmp(pwd1->pw_class, pwd2->pw_class) != 0 ||
            strcmp(pwd1->pw_gecos, pwd2->pw_gecos) != 0 ||
            strcmp(pwd1->pw_dir, pwd2->pw_dir) != 0 ||
            strcmp(pwd1->pw_shell, pwd2->pw_shell) != 0)
                return (-1);
        else
                return (0);
}

static void
free_passwd(struct passwd *pwd)
{
        free(pwd->pw_name);
        free(pwd->pw_passwd);
        free(pwd->pw_class);
        free(pwd->pw_gecos);
        free(pwd->pw_dir);
        free(pwd->pw_shell);
}

static void
sdump_passwd(struct passwd *pwd, char *buffer, size_t buflen)
{
        snprintf(buffer, buflen, "%s:%s:%d:%d:%jd:%s:%s:%s:%s:%jd:%d",
            pwd->pw_name, pwd->pw_passwd, pwd->pw_uid, pwd->pw_gid,
            (uintmax_t)pwd->pw_change, pwd->pw_class, pwd->pw_gecos,
            pwd->pw_dir, pwd->pw_shell, (uintmax_t)pwd->pw_expire,
            pwd->pw_fields);
}

#ifdef DEBUG
static void
dump_passwd(struct passwd *pwd)
{
        if (pwd != NULL) {
                char buffer[2048];
                sdump_passwd(pwd, buffer, sizeof(buffer));
                printf("%s\n", buffer);
        } else
                printf("(null)\n");
}
#endif

static int
passwd_read_snapshot_func(struct passwd *pwd, char *line)
{
        char *s, *ps, *ts;
        int i;

#ifdef DEBUG
        printf("1 line read from snapshot:\n%s\n", line);
#endif

        i = 0;
        ps = line;
        memset(pwd, 0, sizeof(struct passwd));
        while ((s = strsep(&ps, ":")) != NULL) {
                switch (i) {
                case 0:
                        pwd->pw_name = strdup(s);
                        ATF_REQUIRE(pwd->pw_name != NULL);
                        break;
                case 1:
                        pwd->pw_passwd = strdup(s);
                        ATF_REQUIRE(pwd->pw_passwd != NULL);
                        break;
                case 2:
                        pwd->pw_uid = (uid_t)strtol(s, &ts, 10);
                        if (*ts != '\0')
                                goto fin;
                        break;
                case 3:
                        pwd->pw_gid = (gid_t)strtol(s, &ts, 10);
                        if (*ts != '\0')
                                goto fin;
                        break;
                case 4:
                        pwd->pw_change = (time_t)strtol(s, &ts, 10);
                        if (*ts != '\0')
                                goto fin;
                        break;
                case 5:
                        pwd->pw_class = strdup(s);
                        ATF_REQUIRE(pwd->pw_class != NULL);
                        break;
                case 6:
                        pwd->pw_gecos = strdup(s);
                        ATF_REQUIRE(pwd->pw_gecos != NULL);
                        break;
                case 7:
                        pwd->pw_dir = strdup(s);
                        ATF_REQUIRE(pwd->pw_dir != NULL);
                        break;
                case 8:
                        pwd->pw_shell = strdup(s);
                        ATF_REQUIRE(pwd->pw_shell != NULL);
                        break;
                case 9:
                        pwd->pw_expire = (time_t)strtol(s, &ts, 10);
                        if (*ts != '\0')
                                goto fin;
                        break;
                case 10:
                        pwd->pw_fields = (int)strtol(s, &ts, 10);
                        if (*ts != '\0')
                                goto fin;
                        break;
                default:
                        break;
                }
                ++i;
        }

fin:
        if (i != 11) {
                free_passwd(pwd);
                memset(pwd, 0, sizeof(struct passwd));
                return (-1);
        }

        return (0);
}

static int
passwd_fill_test_data(struct passwd_test_data *td,
    int (*cb)(struct passwd *, void *))
{
        struct passwd *pwd;
        const int limit = 1024;
        int count = 0;

        setpassent(1);
        while ((pwd = getpwent()) != NULL) {
                if (passwd_test_correctness(pwd, NULL) == 0) {
                        TEST_DATA_APPEND(passwd, td, pwd);
                        if (cb != NULL && cb(pwd, td) != 0)
                                return (-1);
                } else {
                        return (-1);
                }
                if (++count >= limit)
                        break;
        }
        endpwent();

        return (0);
}

static int
passwd_test_correctness(struct passwd *pwd, void *mdata __unused)
{

#ifdef DEBUG
        printf("testing correctness with the following data:\n");
        dump_passwd(pwd);
#endif

        if (pwd == NULL)
                return (-1);

        if (pwd->pw_name == NULL)
                goto errfin;

        if (pwd->pw_passwd == NULL)
                goto errfin;

        if (pwd->pw_class == NULL)
                goto errfin;

        if (pwd->pw_gecos == NULL)
                goto errfin;

        if (pwd->pw_dir == NULL)
                goto errfin;

        if (pwd->pw_shell == NULL)
                goto errfin;

#ifdef DEBUG
        printf("correct\n");
#endif

        return (0);
errfin:
#ifdef DEBUG
        printf("incorrect\n");
#endif

        return (-1);
}

/* passwd_check_ambiguity() is needed here because when doing the getpwent()
 * calls sequence, records from different nsswitch sources can be different,
 * though having the same pw_name/pw_uid */
static int
passwd_check_ambiguity(struct passwd_test_data *td, struct passwd *pwd)
{

        return (TEST_DATA_FIND(passwd, td, pwd, compare_passwd, NULL) !=
            NULL ? 0 : -1);
}

static int
passwd_test_getpwnam(struct passwd *pwd_model, void *mdata)
{
        struct passwd *pwd;

#ifdef DEBUG
        printf("testing getpwnam() with the following data:\n");
        dump_passwd(pwd_model);
#endif

        pwd = getpwnam(pwd_model->pw_name);
        if (passwd_test_correctness(pwd, NULL) != 0)
                goto errfin;

        if (compare_passwd(pwd, pwd_model, NULL) != 0 &&
            passwd_check_ambiguity((struct passwd_test_data *)mdata, pwd) != 0)
                goto errfin;

#ifdef DEBUG
        printf("ok\n");
#endif
        return (0);

errfin:
#ifdef DEBUG
        printf("not ok\n");
#endif
        return (-1);
}

static int
passwd_test_getpwuid(struct passwd *pwd_model, void *mdata)
{
        struct passwd *pwd;

#ifdef DEBUG
        printf("testing getpwuid() with the following data...\n");
        dump_passwd(pwd_model);
#endif

        pwd = getpwuid(pwd_model->pw_uid);
        if (passwd_test_correctness(pwd, NULL) != 0 ||
            (compare_passwd(pwd, pwd_model, NULL) != 0 &&
            passwd_check_ambiguity((struct passwd_test_data *)mdata,
            pwd) != 0)) {
#ifdef DEBUG
                printf("not ok\n");
#endif
                return (-1);
        } else {
#ifdef DEBUG
                printf("ok\n");
#endif
                return (0);
        }
}

static int
passwd_test_getpwent(struct passwd *pwd, void *mdata __unused)
{
        /*
         * Only correctness can be checked when doing 1-pass test for
         * getpwent().
         */
        return (passwd_test_correctness(pwd, NULL));
}

static int
run_tests(const char *snapshot_file, enum test_methods method)
{
        struct passwd_test_data td, td_snap, td_2pass, td_interleaved;
        int rv;

        TEST_DATA_INIT(passwd, &td, clone_passwd, free_passwd);
        TEST_DATA_INIT(passwd, &td_snap, clone_passwd, free_passwd);
        if (snapshot_file != NULL) {
                if (access(snapshot_file, W_OK | R_OK) != 0) {
                        if (errno == ENOENT)
                                method = TEST_BUILD_SNAPSHOT;
                        else {
                                printf("can't access the file %s\n",
                                    snapshot_file);
                                rv = -1;
                                goto fin;
                        }
                } else {
                        if (method == TEST_BUILD_SNAPSHOT) {
                                rv = 0;
                                goto fin;
                        }

                        TEST_SNAPSHOT_FILE_READ(passwd, snapshot_file,
                            &td_snap, passwd_read_snapshot_func);
                }
        }

        rv = passwd_fill_test_data(&td, NULL);
        if (rv == -1)
                return (-1);

        switch (method) {
        case TEST_GETPWNAM:
                if (snapshot_file == NULL)
                        rv = DO_1PASS_TEST(passwd, &td,
                            passwd_test_getpwnam, (void *)&td);
                else
                        rv = DO_1PASS_TEST(passwd, &td_snap,
                            passwd_test_getpwnam, (void *)&td_snap);
                break;
        case TEST_GETPWUID:
                if (snapshot_file == NULL)
                        rv = DO_1PASS_TEST(passwd, &td,
                            passwd_test_getpwuid, (void *)&td);
                else
                        rv = DO_1PASS_TEST(passwd, &td_snap,
                            passwd_test_getpwuid, (void *)&td_snap);
                break;
        case TEST_GETPWENT:
                if (snapshot_file == NULL)
                        rv = DO_1PASS_TEST(passwd, &td, passwd_test_getpwent,
                            (void *)&td);
                else
                        rv = DO_2PASS_TEST(passwd, &td, &td_snap,
                            compare_passwd, NULL);
                break;
        case TEST_GETPWENT_2PASS:
                TEST_DATA_INIT(passwd, &td_2pass, clone_passwd, free_passwd);
                rv = passwd_fill_test_data(&td_2pass, NULL);
                if (rv != -1)
                        rv = DO_2PASS_TEST(passwd, &td, &td_2pass,
                            compare_passwd, NULL);
                TEST_DATA_DESTROY(passwd, &td_2pass);
                break;
        case TEST_GETPWENT_INTERLEAVED_GETPWNAM:
                TEST_DATA_INIT(passwd, &td_interleaved, clone_passwd, free_passwd);
                rv = passwd_fill_test_data(&td_interleaved, passwd_test_getpwnam);
                if (rv != -1)
                        rv = DO_2PASS_TEST(passwd, &td, &td_interleaved,
                            compare_passwd, NULL);
                TEST_DATA_DESTROY(passwd, &td_interleaved);
                break;
        case TEST_GETPWENT_INTERLEAVED_GETPWUID:
                TEST_DATA_INIT(passwd, &td_interleaved, clone_passwd, free_passwd);
                rv = passwd_fill_test_data(&td_interleaved, passwd_test_getpwuid);
                if (rv != -1)
                        rv = DO_2PASS_TEST(passwd, &td, &td_interleaved,
                            compare_passwd, NULL);
                TEST_DATA_DESTROY(passwd, &td_interleaved);
                break;
        case TEST_BUILD_SNAPSHOT:
                if (snapshot_file != NULL)
                        rv = TEST_SNAPSHOT_FILE_WRITE(passwd, snapshot_file,
                            &td, sdump_passwd);
                break;
        default:
                rv = 0;
                break;
        }

fin:
        TEST_DATA_DESTROY(passwd, &td_snap);
        TEST_DATA_DESTROY(passwd, &td);

        return (rv);
}

#define SNAPSHOT_FILE   "snapshot_pwd"

ATF_TC_WITHOUT_HEAD(getpwent);
ATF_TC_BODY(getpwent, tc)
{
        ATF_REQUIRE(run_tests(NULL, TEST_GETPWENT) == 0);
}

ATF_TC_WITHOUT_HEAD(getpwent_with_snapshot);
ATF_TC_BODY(getpwent_with_snapshot, tc)
{
        ATF_REQUIRE(run_tests(SNAPSHOT_FILE, TEST_BUILD_SNAPSHOT) == 0);
        ATF_REQUIRE(run_tests(SNAPSHOT_FILE, TEST_GETPWENT) == 0);
}

ATF_TC_WITHOUT_HEAD(getpwent_with_two_pass);
ATF_TC_BODY(getpwent_with_two_pass, tc)
{
        ATF_REQUIRE(run_tests(NULL, TEST_GETPWENT_2PASS) == 0);
}

ATF_TC_WITHOUT_HEAD(getpwnam);
ATF_TC_BODY(getpwnam, tc)
{
        ATF_REQUIRE(run_tests(NULL, TEST_GETPWNAM) == 0);
}

ATF_TC_WITHOUT_HEAD(getpwnam_with_snapshot);
ATF_TC_BODY(getpwnam_with_snapshot, tc)
{
        ATF_REQUIRE(run_tests(SNAPSHOT_FILE, TEST_BUILD_SNAPSHOT) == 0);
        ATF_REQUIRE(run_tests(SNAPSHOT_FILE, TEST_GETPWNAM) == 0);
}

ATF_TC_WITHOUT_HEAD(getpwuid);
ATF_TC_BODY(getpwuid, tc)
{
        ATF_REQUIRE(run_tests(NULL, TEST_GETPWUID) == 0);
}

ATF_TC_WITHOUT_HEAD(getpwuid_with_snapshot);
ATF_TC_BODY(getpwuid_with_snapshot, tc)
{
        ATF_REQUIRE(run_tests(SNAPSHOT_FILE, TEST_BUILD_SNAPSHOT) == 0);
        ATF_REQUIRE(run_tests(SNAPSHOT_FILE, TEST_GETPWUID) == 0);
}

ATF_TC_WITHOUT_HEAD(getpwent_interleaved_getpwnam);
ATF_TC_BODY(getpwent_interleaved_getpwnam, tc)
{
        ATF_REQUIRE(run_tests(NULL, TEST_GETPWENT_INTERLEAVED_GETPWNAM) == 0);
}

ATF_TC_WITHOUT_HEAD(getpwent_interleaved_getpwuid);
ATF_TC_BODY(getpwent_interleaved_getpwuid, tc)
{
        ATF_REQUIRE(run_tests(NULL, TEST_GETPWENT_INTERLEAVED_GETPWUID) == 0);
}

ATF_TP_ADD_TCS(tp)
{
        ATF_TP_ADD_TC(tp, getpwent);
        ATF_TP_ADD_TC(tp, getpwent_with_snapshot);
        ATF_TP_ADD_TC(tp, getpwent_with_two_pass);
        ATF_TP_ADD_TC(tp, getpwnam);
        ATF_TP_ADD_TC(tp, getpwnam_with_snapshot);
        ATF_TP_ADD_TC(tp, getpwuid);
        ATF_TP_ADD_TC(tp, getpwuid_with_snapshot);
        ATF_TP_ADD_TC(tp, getpwent_interleaved_getpwnam);
        ATF_TP_ADD_TC(tp, getpwent_interleaved_getpwuid);

        return (atf_no_error());
}