SM2FILE(1)							  ICI executables							SM2FILE(1)

NAME

       sm2file - shared-memory linked list data extraction test program

SYNOPSIS

       sm2file

DESCRIPTION

       sm2file stress-tests shared-memory linked list data extraction by retrieving and deleting all text file lines inserted into a shared-memory
       linked list that is the root object of a PSM partition named "file2sm".

       The operation of sm2file echoes the cyclical operation of file2sm: the EOF lines inserted into the linked list by file2sm punctuate the
       writing of files that are copies of file2sm's original source text file.  The name of each file written by sm2file is file_copy_cycleNbr,
       where cycleNbr is, in effect, the count of EOF lines encountered in the linked list up to the point at which the writing of this file
       began.

       sm2file may catch up with the data ingestion activity of file2sm, in which case it blocks (taking the file2sm test semaphore) until the
       linked list is no longer empty.

EXIT STATUS

       0   sm2file has terminated.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

       can't attach to shared memory
	   Operating system error.  Check errtext, correct problem, and rerun.

       Can't manage shared memory.
	   PSM error.  Check for earlier diagnostics describing the cause of the error; correct problem and rerun.

       Can't create shared memory list.
	   PSM error.  Check for earlier diagnostics describing the cause of the error; correct problem and rerun.

       Can't create semaphore.
	   ION system error.  Check for earlier diagnostics describing the cause of the error; correct problem and rerun.

       Can't open output file
	   Operating system error.  Check errtext, correct problem, and rerun.

       can't write to output file
	   Operating system error.  Check errtext, correct problem, and rerun.

BUGS

       Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>

SEE ALSO

       file2sm(1), smlist(3), psm(3)

perl v5.14.2							    2012-05-25								SM2FILE(1)