testcases/kernel/syscalls/symlink/symlink03.c - platform/external/ltp - Gitiles

 /*
  *
  *   Copyright (c) International Business Machines  Corp., 2001
  *
  *   This program 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 program 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, write to the Free Software
  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  */

 /*
  * Test Name : symlink03
  *
  * Test Description :
  *   Verify that,
  *   1) symlink(2) returns -1 and sets errno to EACCES if search/write
  *	permission is denied in the directory where the symbolic link is
  *	being created.
  *   2) symlink(2) returns -1 and sets errno to EEXIST if the specified
  *	symbolic link already exists.
  *   3) symlink(2) returns -1 and sets errno to EFAULT if the specified
  *	file or symbolic link points to invalid address.
  *   4) symlink(2) returns -1 and sets errno to ENAMETOOLONG if the
  *	pathname component of symbolic link is too long (ie, > PATH_MAX).
  *   5) symlink(2) returns -1 and sets errno to ENOTDIR if the directory
  *	component in pathname of symbolic link is not a directory.
  *   6) symlink(2) returns -1 and sets errno to ENOENT if the component of
  *	symbolic link points to an empty string.
  *
  * Expected Result:
  *  symlink() should fail with return value -1 and set expected errno.
  *
  * Algorithm:
  *  Setup:
  *   Setup signal handling.
  *   Create temporary directory.
  *   Pause for SIGUSR1 if option specified.
  *
  *  Test:
  *   Loop if the proper options are given.
  *   Execute system call
  *   Check return code, if system call failed (return=-1)
  *   	if errno set == expected errno
  *   		Issue sys call fails with expected return value and errno.
  *   	Otherwise,
  *		Issue sys call fails with unexpected errno.
  *   Otherwise,
  *	Issue sys call returns unexpected value.
  *
  *  Cleanup:
  *   Print errno log and/or timing stats if options given
  *   Delete the temporary directory(s)/file(s) created.
  *
  * Usage:  <for command-line>
  *  symlink03 [-c n] [-e] [-i n] [-I x] [-p x] [-t]
  *	where,  -c n : Run n copies concurrently.
  *		-e   : Turn on errno logging.
  *		-i n : Execute test n times.
  *		-I x : Execute test for x seconds.
  *		-P x : Pause for x seconds between iterations.
  *		-t   : Turn on syscall timing.
  *
  * History
  *	07/2001 John George
  *		-Ported
  *
  * Restrictions:
  */

 #include <stdio.h>
 #include <sys/types.h>
 #include <sys/fcntl.h>
 #include <sys/mman.h>
 #include <errno.h>
 #include <string.h>
 #include <signal.h>
 #include <sys/stat.h>
 #include <pwd.h>

 #include "test.h"
 #include "usctest.h"

 #define MODE_RWX        S_IRWXU | S_IRWXG | S_IRWXO
 #define FILE_MODE       S_IRUSR | S_IRGRP | S_IROTH
 #define DIR_TEMP        "testdir_1"
 #define TESTFILE	"testfile"
 #define TEST_FILE1      "testdir_1/tfile_1"
 #define SYM_FILE1	"testdir_1/sfile_1"
 #define TEST_FILE2      "tfile_2"
 #define SYM_FILE2	"sfile_2"
 #define TEST_FILE3      "tfile_3"
 #define SYM_FILE3	"t_file/sfile_3"

 char *TCID="symlink03";		/* Test program identifier.    */
 int TST_TOTAL=1;		/* Total number of test cases. */
 extern int Tst_count;		/* Test Case counter for tst_* routines */
 int exp_enos[]={ENOTDIR, ENOENT, ENAMETOOLONG, EFAULT,  EEXIST, EACCES, 0};

 char * bad_addr = 0;

 int no_setup();
 int setup1();                   /* setup function to test symlink for EACCES */
 int setup2();                   /* setup function to test symlink for EEXIST */
 int setup3();                   /* setup function to test symlink for ENOTDIR */
 int longpath_setup();   /* setup function to test chmod for ENAMETOOLONG */

 char Longpathname[PATH_MAX+2];
 char High_address_node[64];

 struct test_case_t {		/* test case struct. to hold ref. test cond's*/
 	char *file;
 	char *link;
 	char *desc;
 	int exp_errno;
 	int (*setupfunc)();
 } Test_cases[] = {
 	{ TEST_FILE1, SYM_FILE1, "No Search permissions to process", EACCES, setup1 },
 	{ TEST_FILE2, SYM_FILE2, "Specified symlink already exists", EEXIST, setup2 },
 #if !defined(UCLINUX)
 	{ TESTFILE, High_address_node, "Address beyond address space", EFAULT, no_setup },
 #endif
 	{ TESTFILE, (char *)-1, "Negative address", EFAULT, no_setup },
 	{ TESTFILE, Longpathname, "Symlink path too long", ENAMETOOLONG, longpath_setup },
 	{ TESTFILE, "", "Symlink Pathname is empty", ENOENT, no_setup },
 	{ TEST_FILE3, SYM_FILE3, "Symlink Path contains regular file", ENOTDIR, setup3 },
 	{ NULL, NULL, NULL, 0, no_setup }
 };

 char nobody_uid[] = "nobody";
 struct passwd *ltpuser;

 void setup();		/* Setup function for the test */
 void cleanup();		/* Cleanup function for the test */

 int
 main(int ac, char **av)
 {
 	int lc;			/* loop counter */
 	char *msg;		/* message returned from parse_opts */
 	char *test_file;	/* testfile name */
 	char *sym_file;		/* symbolic link file name */
 	char *test_desc;	/* test specific error message */
 	int ind;		/* counter to test different test conditions */

 	/* Parse standard options given to run the test. */
 	msg = parse_opts(ac, av, (option_t *) NULL, NULL);
 	if (msg != (char *) NULL) {
 		tst_brkm(TBROK, NULL, "OPTION PARSING ERROR - %s", msg);
 		tst_exit();
 		/*NOTREACHED*/
 	}

 	/*
 	 * Invoke setup function to call individual test setup functions
 	 * to simulate test conditions.
 	 */
 	setup();

 	/* set the expected errnos... */
 	TEST_EXP_ENOS(exp_enos);

 	/* Check looping state if -i option given */
 	for (lc = 0; TEST_LOOPING(lc); lc++) {
 		/* Reset Tst_count in case we are looping. */
 		Tst_count=0;

 		for (ind = 0; Test_cases[ind].desc != NULL; ind++) {
 			test_file = Test_cases[ind].file;
 			sym_file = Test_cases[ind].link;
 			test_desc = Test_cases[ind].desc;
 #if !defined(UCLINUX)
 			if (sym_file == High_address_node) {
 				sym_file = (char *)get_high_address();
 			}
 #endif
 			/*
 			 * Call symlink(2) to test different test conditions.
 	 		 * verify that it fails with -1 return value and sets
 			 * appropriate errno.
 			 */
 			TEST(symlink(test_file, sym_file));

 			/* Check return code of symlink(2) */
 			if (TEST_RETURN == -1) {
 				/*
 				 * Perform functional verification if
 				 * test executed without (-f) option.
 				 */
 				TEST_ERROR_LOG(TEST_ERRNO);
 				if (TEST_ERRNO == Test_cases[ind].exp_errno) {
 					tst_resm(TPASS, "symlink() Fails, %s, "
 						"errno=%d", test_desc,
 						TEST_ERRNO);
 				} else {
 					tst_resm(TFAIL, "symlink() Fails, %s, "
 						"errno=%d, expected errno=%d",
 						test_desc, TEST_ERRNO,
 						Test_cases[ind].exp_errno);
 				}
 			} else {
 				tst_resm(TFAIL, "symlink() returned %d, "
 					"expected -1, errno:%d", TEST_RETURN,
 					Test_cases[ind].exp_errno);
 			}
 		}	/* End of TEST CASE LOOPING. */

 		Tst_count++;		/* incr. TEST_LOOP counter */
 	}	/* End for TEST_LOOPING */

 	/* Call cleanup() to undo setup done for the test. */
 	cleanup();
 	/*NOTREACHED*/


   return 0;

 }	/* End main */

 /*
  * void
  * setup() - performs all ONE TIME setup for this test.
  *  Create a temporary directory and change directory to it.
  *  Call test specific setup functions.
  */
 void
 setup()
 {
 	int ind;
 	/* capture signals */
 	tst_sig(NOFORK, DEF_HANDLER, cleanup);

 	/* Pause if that option was specified
 	 * TEST_PAUSE contains the code to fork the test with the -i option.
 	 * You want to make sure you do this before you create your temporary
 	 * directory.
 	 */
 	TEST_PAUSE;

 	/* Switch to nobody user for correct error code collection */
         if (geteuid() != 0) {
                 tst_brkm(TBROK, tst_exit, "Test must be run as root");
         }
         ltpuser = getpwnam(nobody_uid);
         if (setuid(ltpuser->pw_uid) == -1) {
                 tst_resm(TINFO, "setuid failed to "
                          "to set the effective uid to %d",
                          ltpuser->pw_uid);
                 perror("setuid");
         }


 	/* make a temp directory and cd to it */
 	tst_tmpdir();

 #if !defined(UCLINUX)
 	bad_addr = mmap(0, 1, PROT_NONE,
 			MAP_PRIVATE_EXCEPT_UCLINUX|MAP_ANONYMOUS, 0, 0);
 	if (bad_addr == MAP_FAILED) {
 		tst_brkm(TBROK, cleanup, "mmap failed");
 	}
 	Test_cases[3].link = bad_addr;
 #endif

 	/* call individual setup functions */
 	for (ind = 0; Test_cases[ind].desc != NULL; ind++) {
 		Test_cases[ind].setupfunc();
 	}
 }	/* End setup() */

 /*
  * int
  * no_setup() - Some test conditions for mknod(2) do not any setup.
  *              Hence, this function just returns 0.
  *  This function simply returns 0.
  */
 int
 no_setup()
 {
         return 0;
 }

 /*
  * int
  * setup1() - setup function for a test condition for which symlink(2)
  *            returns -1 and sets errno to EACCES.
  *  Create a test directory under temporary directory and create a test file
  *  under this directory with mode "0666" permissions.
  *  Modify the mode permissions on test directory such that process will not
  *  have search permissions on test directory.
  *
  *  The function returns 0.
  */
 int
 setup1()
 {
         int fd;                 /* file handle for testfile */

         if (mkdir(DIR_TEMP, MODE_RWX) < 0) {
                 tst_brkm(TBROK, cleanup, "mkdir(2) of %s failed", DIR_TEMP);
 		/*NOTREACHED*/
         }

         if ((fd = open(TEST_FILE1, O_RDWR|O_CREAT, 0666)) == -1) {
                 tst_brkm(TBROK, cleanup,
                          "open(%s, O_RDWR|O_CREAT, 0666) failed, errno=%d : %s",
                          TEST_FILE1, errno, strerror(errno));
 		/*NOTREACHED*/
         }
         if (close(fd) == -1) {
                 tst_brkm(TBROK, cleanup,
                          "close(%s) Failed, errno=%d : %s",
                          TEST_FILE1, errno, strerror(errno));
 		/*NOTREACHED*/
         }

 	/* Modify mode permissions on test directory */
         if (chmod(DIR_TEMP, FILE_MODE) < 0) {
                 tst_brkm(TBROK, cleanup, "chmod(2) of %s failed", DIR_TEMP);
 		/*NOTREACHED*/
         }
         return 0;
 }

 /*
  * int
  * setup2() - EEXIST
  */
 int
 setup2()
 {
 	int fd;			/* file handle for testfile */

         if ((fd = open(TEST_FILE2, O_RDWR|O_CREAT, 0666)) == -1) {
                 tst_brkm(TBROK, cleanup,
                          "open(%s, O_RDWR|O_CREAT, 0666) failed, errno=%d : %s",
                          TEST_FILE1, errno, strerror(errno));
 		/*NOTREACHED*/
 		}
 		if (close(fd) == -1) {
 			tst_brkm(TBROK, cleanup,
 				"close(%s) Failed, errno=%d : %s",
 				TEST_FILE2, errno, strerror(errno));
 		/*NOTREACHED*/
 		}

 	if (symlink(TEST_FILE2, SYM_FILE2) < 0) {
 		tst_brkm(TBROK, cleanup,
 			 "symlink() Fails to create %s in setup2, error=%d",
 			 SYM_FILE2, errno);
 		/*NOTREACHED*/
 	}
 	return 0;
 }

 /*
  * int
  * longpath_setup() - setup to create a node with a name length exceeding
  *                    the MAX. length of PATH_MAX.
  *   This function retruns 0.
  */
 int
 longpath_setup()
 {
 	int ind;                /* counter variable */

 	for (ind = 0; ind <= (PATH_MAX + 1); ind++) {
 		Longpathname[ind] = 'a';
 	}
 	return 0;
 }

 /*
  * int
  * setup3() - setup function for a test condition for which symlink(2)
  *           returns -1 and sets errno to ENOTDIR.
  *
  *  Create a symlink file under temporary directory so that test tries to
  *  create symlink file "tfile_3" under "t_file" which happens to be
  *  another symlink file.
  */
 int
 setup3()
 {
 	int fd;			/* file handle for testfile */

 	/* Creat/open a testfile and close it */
 	if ((fd = open("t_file", O_RDWR|O_CREAT, MODE_RWX)) == -1) {
 		tst_brkm(TBROK, cleanup,
 			"open(2) on t_file failed, errno=%d : %s",
 			errno, strerror(errno));
 		/*NOTREACHED*/
 	}
 	if (close(fd) == -1) {
 		tst_brkm(TBROK, cleanup, "close(t_file) Failed, errno=%d : %s",
 			errno, strerror(errno));
 		/*NOTREACHED*/
         }
 	return 0;
 }

 /*
  * void
  * cleanup() - performs all ONE TIME cleanup for this test at
  *             completion or premature exit.
  *  Restore the mode permissions on test directory.
  *  Remove the temporary directory created in the setup.
  */
 void
 cleanup()
 {
 	/*
 	 * print timing stats if that option was specified.
 	 * print errno log if that option was specified.
 	 */
 	TEST_CLEANUP;

 	/* Restore mode permissions on test directory created in setup2() */
 	if (chmod(DIR_TEMP, MODE_RWX) < 0) {
 		tst_brkm(TBROK, NULL, "chmod(2) of %s failed", DIR_TEMP);
 	}

 	/* Remove tmp dir and all files in it */
 	tst_rmdir();

 	/* exit with return code appropriate for results */
 	tst_exit();
 }	/* End cleanup() */
	/*
	*
	* Copyright (c) International Business Machines Corp., 2001
	*
	* This program 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 program 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, write to the Free Software
	* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
	*/

	/*
	* Test Name : symlink03
	*
	* Test Description :
	* Verify that,
	* 1) symlink(2) returns -1 and sets errno to EACCES if search/write
	* permission is denied in the directory where the symbolic link is
	* being created.
	* 2) symlink(2) returns -1 and sets errno to EEXIST if the specified
	* symbolic link already exists.
	* 3) symlink(2) returns -1 and sets errno to EFAULT if the specified
	* file or symbolic link points to invalid address.
	* 4) symlink(2) returns -1 and sets errno to ENAMETOOLONG if the
	* pathname component of symbolic link is too long (ie, > PATH_MAX).
	* 5) symlink(2) returns -1 and sets errno to ENOTDIR if the directory
	* component in pathname of symbolic link is not a directory.
	* 6) symlink(2) returns -1 and sets errno to ENOENT if the component of
	* symbolic link points to an empty string.
	*
	* Expected Result:
	* symlink() should fail with return value -1 and set expected errno.
	*
	* Algorithm:
	* Setup:
	* Setup signal handling.
	* Create temporary directory.
	* Pause for SIGUSR1 if option specified.
	*
	* Test:
	* Loop if the proper options are given.
	* Execute system call
	* Check return code, if system call failed (return=-1)
	* if errno set == expected errno
	* Issue sys call fails with expected return value and errno.
	* Otherwise,
	* Issue sys call fails with unexpected errno.
	* Otherwise,
	* Issue sys call returns unexpected value.
	*
	* Cleanup:
	* Print errno log and/or timing stats if options given
	* Delete the temporary directory(s)/file(s) created.
	*
	* Usage: <for command-line>
	* symlink03 [-c n] [-e] [-i n] [-I x] [-p x] [-t]
	* where, -c n : Run n copies concurrently.
	* -e : Turn on errno logging.
	* -i n : Execute test n times.
	* -I x : Execute test for x seconds.
	* -P x : Pause for x seconds between iterations.
	* -t : Turn on syscall timing.
	*
	* History
	* 07/2001 John George
	* -Ported
	*
	* Restrictions:
	*/

	#include <stdio.h>
	#include <sys/types.h>
	#include <sys/fcntl.h>
	#include <sys/mman.h>
	#include <errno.h>
	#include <string.h>
	#include <signal.h>
	#include <sys/stat.h>
	#include <pwd.h>

	#include "test.h"
	#include "usctest.h"

	#define MODE_RWX S_IRWXU \| S_IRWXG \| S_IRWXO
	#define FILE_MODE S_IRUSR \| S_IRGRP \| S_IROTH
	#define DIR_TEMP "testdir_1"
	#define TESTFILE "testfile"
	#define TEST_FILE1 "testdir_1/tfile_1"
	#define SYM_FILE1 "testdir_1/sfile_1"
	#define TEST_FILE2 "tfile_2"
	#define SYM_FILE2 "sfile_2"
	#define TEST_FILE3 "tfile_3"
	#define SYM_FILE3 "t_file/sfile_3"

	char TCID="symlink03"; / Test program identifier. */
	int TST_TOTAL=1; /* Total number of test cases. */
	extern int Tst_count; /* Test Case counter for tst_* routines */
	int exp_enos[]={ENOTDIR, ENOENT, ENAMETOOLONG, EFAULT, EEXIST, EACCES, 0};

	char * bad_addr = 0;

	int no_setup();
	int setup1(); /* setup function to test symlink for EACCES */
	int setup2(); /* setup function to test symlink for EEXIST */
	int setup3(); /* setup function to test symlink for ENOTDIR */
	int longpath_setup(); /* setup function to test chmod for ENAMETOOLONG */

	char Longpathname[PATH_MAX+2];
	char High_address_node[64];

	struct test_case_t { /* test case struct. to hold ref. test cond's*/
	char *file;
	char *link;
	char *desc;
	int exp_errno;
	int (*setupfunc)();
	} Test_cases[] = {
	{ TEST_FILE1, SYM_FILE1, "No Search permissions to process", EACCES, setup1 },
	{ TEST_FILE2, SYM_FILE2, "Specified symlink already exists", EEXIST, setup2 },
	#if !defined(UCLINUX)
	{ TESTFILE, High_address_node, "Address beyond address space", EFAULT, no_setup },
	#endif
	{ TESTFILE, (char *)-1, "Negative address", EFAULT, no_setup },
	{ TESTFILE, Longpathname, "Symlink path too long", ENAMETOOLONG, longpath_setup },
	{ TESTFILE, "", "Symlink Pathname is empty", ENOENT, no_setup },
	{ TEST_FILE3, SYM_FILE3, "Symlink Path contains regular file", ENOTDIR, setup3 },
	{ NULL, NULL, NULL, 0, no_setup }
	};

	char nobody_uid[] = "nobody";
	struct passwd *ltpuser;

	void setup(); /* Setup function for the test */
	void cleanup(); /* Cleanup function for the test */

	int
	main(int ac, char **av)
	{
	int lc; /* loop counter */
	char msg; / message returned from parse_opts */
	char test_file; / testfile name */
	char sym_file; / symbolic link file name */
	char test_desc; / test specific error message */
	int ind; /* counter to test different test conditions */

	/* Parse standard options given to run the test. */
	msg = parse_opts(ac, av, (option_t *) NULL, NULL);
	if (msg != (char *) NULL) {
	tst_brkm(TBROK, NULL, "OPTION PARSING ERROR - %s", msg);
	tst_exit();
	/NOTREACHED/
	}

	/*
	* Invoke setup function to call individual test setup functions
	* to simulate test conditions.
	*/
	setup();

	/* set the expected errnos... */
	TEST_EXP_ENOS(exp_enos);

	/* Check looping state if -i option given */
	for (lc = 0; TEST_LOOPING(lc); lc++) {
	/* Reset Tst_count in case we are looping. */
	Tst_count=0;

	for (ind = 0; Test_cases[ind].desc != NULL; ind++) {
	test_file = Test_cases[ind].file;
	sym_file = Test_cases[ind].link;
	test_desc = Test_cases[ind].desc;
	#if !defined(UCLINUX)
	if (sym_file == High_address_node) {
	sym_file = (char *)get_high_address();
	}
	#endif
	/*
	* Call symlink(2) to test different test conditions.
	* verify that it fails with -1 return value and sets
	* appropriate errno.
	*/
	TEST(symlink(test_file, sym_file));

	/* Check return code of symlink(2) */
	if (TEST_RETURN == -1) {
	/*
	* Perform functional verification if
	* test executed without (-f) option.
	*/
	TEST_ERROR_LOG(TEST_ERRNO);
	if (TEST_ERRNO == Test_cases[ind].exp_errno) {
	tst_resm(TPASS, "symlink() Fails, %s, "
	"errno=%d", test_desc,
	TEST_ERRNO);
	} else {
	tst_resm(TFAIL, "symlink() Fails, %s, "
	"errno=%d, expected errno=%d",
	test_desc, TEST_ERRNO,
	Test_cases[ind].exp_errno);
	}
	} else {
	tst_resm(TFAIL, "symlink() returned %d, "
	"expected -1, errno:%d", TEST_RETURN,
	Test_cases[ind].exp_errno);
	}
	} /* End of TEST CASE LOOPING. */

	Tst_count++; /* incr. TEST_LOOP counter */
	} /* End for TEST_LOOPING */

	/* Call cleanup() to undo setup done for the test. */
	cleanup();
	/NOTREACHED/


	return 0;

	} /* End main */

	/*
	* void
	* setup() - performs all ONE TIME setup for this test.
	* Create a temporary directory and change directory to it.
	* Call test specific setup functions.
	*/
	void
	setup()
	{
	int ind;
	/* capture signals */
	tst_sig(NOFORK, DEF_HANDLER, cleanup);

	/* Pause if that option was specified
	* TEST_PAUSE contains the code to fork the test with the -i option.
	* You want to make sure you do this before you create your temporary
	* directory.
	*/
	TEST_PAUSE;

	/* Switch to nobody user for correct error code collection */
	if (geteuid() != 0) {
	tst_brkm(TBROK, tst_exit, "Test must be run as root");
	}
	ltpuser = getpwnam(nobody_uid);
	if (setuid(ltpuser->pw_uid) == -1) {
	tst_resm(TINFO, "setuid failed to "
	"to set the effective uid to %d",
	ltpuser->pw_uid);
	perror("setuid");
	}


	/* make a temp directory and cd to it */
	tst_tmpdir();

	#if !defined(UCLINUX)
	bad_addr = mmap(0, 1, PROT_NONE,
	MAP_PRIVATE_EXCEPT_UCLINUX\|MAP_ANONYMOUS, 0, 0);
	if (bad_addr == MAP_FAILED) {
	tst_brkm(TBROK, cleanup, "mmap failed");
	}
	Test_cases[3].link = bad_addr;
	#endif

	/* call individual setup functions */
	for (ind = 0; Test_cases[ind].desc != NULL; ind++) {
	Test_cases[ind].setupfunc();
	}
	} /* End setup() */

	/*
	* int
	* no_setup() - Some test conditions for mknod(2) do not any setup.
	* Hence, this function just returns 0.
	* This function simply returns 0.
	*/
	int
	no_setup()
	{
	return 0;
	}

	/*
	* int
	* setup1() - setup function for a test condition for which symlink(2)
	* returns -1 and sets errno to EACCES.
	* Create a test directory under temporary directory and create a test file
	* under this directory with mode "0666" permissions.
	* Modify the mode permissions on test directory such that process will not
	* have search permissions on test directory.
	*
	* The function returns 0.
	*/
	int
	setup1()
	{
	int fd; /* file handle for testfile */

	if (mkdir(DIR_TEMP, MODE_RWX) < 0) {
	tst_brkm(TBROK, cleanup, "mkdir(2) of %s failed", DIR_TEMP);
	/NOTREACHED/
	}

	if ((fd = open(TEST_FILE1, O_RDWR\|O_CREAT, 0666)) == -1) {
	tst_brkm(TBROK, cleanup,
	"open(%s, O_RDWR\|O_CREAT, 0666) failed, errno=%d : %s",
	TEST_FILE1, errno, strerror(errno));
	/NOTREACHED/
	}
	if (close(fd) == -1) {
	tst_brkm(TBROK, cleanup,
	"close(%s) Failed, errno=%d : %s",
	TEST_FILE1, errno, strerror(errno));
	/NOTREACHED/
	}

	/* Modify mode permissions on test directory */
	if (chmod(DIR_TEMP, FILE_MODE) < 0) {
	tst_brkm(TBROK, cleanup, "chmod(2) of %s failed", DIR_TEMP);
	/NOTREACHED/
	}
	return 0;
	}

	/*
	* int
	* setup2() - EEXIST
	*/
	int
	setup2()
	{
	int fd; /* file handle for testfile */

	if ((fd = open(TEST_FILE2, O_RDWR\|O_CREAT, 0666)) == -1) {
	tst_brkm(TBROK, cleanup,
	"open(%s, O_RDWR\|O_CREAT, 0666) failed, errno=%d : %s",
	TEST_FILE1, errno, strerror(errno));
	/NOTREACHED/
	}
	if (close(fd) == -1) {
	tst_brkm(TBROK, cleanup,
	"close(%s) Failed, errno=%d : %s",
	TEST_FILE2, errno, strerror(errno));
	/NOTREACHED/
	}

	if (symlink(TEST_FILE2, SYM_FILE2) < 0) {
	tst_brkm(TBROK, cleanup,
	"symlink() Fails to create %s in setup2, error=%d",
	SYM_FILE2, errno);
	/NOTREACHED/
	}
	return 0;
	}

	/*
	* int
	* longpath_setup() - setup to create a node with a name length exceeding
	* the MAX. length of PATH_MAX.
	* This function retruns 0.
	*/
	int
	longpath_setup()
	{
	int ind; /* counter variable */

	for (ind = 0; ind <= (PATH_MAX + 1); ind++) {
	Longpathname[ind] = 'a';
	}
	return 0;
	}

	/*
	* int
	* setup3() - setup function for a test condition for which symlink(2)
	* returns -1 and sets errno to ENOTDIR.
	*
	* Create a symlink file under temporary directory so that test tries to
	* create symlink file "tfile_3" under "t_file" which happens to be
	* another symlink file.
	*/
	int
	setup3()
	{
	int fd; /* file handle for testfile */

	/* Creat/open a testfile and close it */
	if ((fd = open("t_file", O_RDWR\|O_CREAT, MODE_RWX)) == -1) {
	tst_brkm(TBROK, cleanup,
	"open(2) on t_file failed, errno=%d : %s",
	errno, strerror(errno));
	/NOTREACHED/
	}
	if (close(fd) == -1) {
	tst_brkm(TBROK, cleanup, "close(t_file) Failed, errno=%d : %s",
	errno, strerror(errno));
	/NOTREACHED/
	}
	return 0;
	}

	/*
	* void
	* cleanup() - performs all ONE TIME cleanup for this test at
	* completion or premature exit.
	* Restore the mode permissions on test directory.
	* Remove the temporary directory created in the setup.
	*/
	void
	cleanup()
	{
	/*
	* print timing stats if that option was specified.
	* print errno log if that option was specified.
	*/
	TEST_CLEANUP;

	/* Restore mode permissions on test directory created in setup2() */
	if (chmod(DIR_TEMP, MODE_RWX) < 0) {
	tst_brkm(TBROK, NULL, "chmod(2) of %s failed", DIR_TEMP);
	}

	/* Remove tmp dir and all files in it */
	tst_rmdir();

	/* exit with return code appropriate for results */
	tst_exit();
	} /* End cleanup() */