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)