


     ftok_L(LSB.os/ipc)	Release	1.1 (UniSoft Ltd.)  ftok_L(LSB.os/ipc)



     NAME
	  LSB.os/ipc/ftok_L - generate an IPC key test case

     DESCRIPTION
	  This test case tests the ftok() system call interface	for
	  conformance to parts of The Open Group's CAE Specification:
	  System Interfaces and	Headers, page:ftok()

     TESTS
	  1    On a call to ftok(path, id), the	pathname path is
	       resolved	in accordance with the requirements for
	       pathname	resolution.

	  2    On a call to ftok(path, id), the	filename path supports
	       portable	filenames.

	  3    When path1 names	a file and path2 names a symbolic link
	       that points to path1, then a successful call to
	       ftok(path1, id) returns the same	key as the one
	       returned	by a successful	call to	ftok(path2, id).

	  4    When the	values of id1 and id2 are not equal, and the
	       values of the bottom 8 bits of id1 and id2 are equal
	       and non-zero, then a successful call to ftok(path, id1)
	       returns the same	key as the one returned	by a
	       successful call to ftok(path, id2).

	  5    When search permission is denied	for a component	of
	       path, then a call to ftok(path, id) returns -1 with
	       errno set to EACCES.

	  6    When too	many symbolic links are	encountered in
	       resolving path, then a call to ftok(path, id) returns
	       -1 with errno set to ELOOP.

	  7    If _POSIX_PATH_MAX <= {PATH_MAX}	<= PCTS_PATH_MAX:
		    When the length of the path	argument exceeds
		    {PATH_MAX},	then a call to ftok(path, id) returns
		    -1 with errno set to ENAMETOOLONG.
	       Otherwise:
		    When the length of the path	argument equals
		    PCTS_PATH_MAX, then	a call to ftok(path, id) does
		    not	give an	ENAMETOOLONG error.

	  8    When a component	of path	does not name an existing
	       file, then a call to ftok(path, id) returns -1 with
	       errno set to ENOENT.

	  9    When path is an empty string, then a call to
	       ftok(path, id) returns -1 with errno set	to ENOENT.

	  10   When a component	of the path prefix is not a directory,



     Page 1					    (printed 2/21/103)






     ftok_L(LSB.os/ipc)	Release	1.1 (UniSoft Ltd.)  ftok_L(LSB.os/ipc)



	       then a call to ftok(path, id) returns -1	with errno set
	       to ENOTDIR.

     Untestable	aspects
	  1    When path is a symbolic link and	the resolution of path
	       produces	an intermediate	result whose length exceeds
	       {PATH_MAX}, then	a call to ftok(path, id) returns -1
	       and errno is set	to ENAMETOOLONG.
	       Reason for omission: There is no	known portable test
	       method for this assertion.

     RELEASE
	  LSB-os 1.1 (00/11/23)










































     Page 2					    (printed 2/21/103)



