---
name: "sm2file"
section: "1"
platform: "linux"
package: "ion"
version: "3.2.1+dfsg-1.1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/sm2file"
---

# sm2file(1)

shared-memory linked list data extraction test program

## 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)](/file2sm/1.md), [*smlist*(3)](/smlist/3.md), [*psm*(3)](/psm/3.md)