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

# file2sm(1)

shared-memory linked list data ingestion test program

## NAME

file2sm - shared-memory linked list data ingestion test program

## SYNOPSIS

**file2sm** *fileName*

## DESCRIPTION

**file2sm** stress-tests shared-memory linked list data ingestion by repeatedly writing all text lines of the file named *fileName* to a shared-memory linked list that is the root object of a PSM partition named "file2sm".

After writing each line to the linked list, **file2sm** gives a semaphore to indicate that the list is now non-empty.  This is mainly for the benefit of the complementary test program [*sm2file*(1)](/sm2file/1.md).

The operation of **file2sm** is cyclical.  After copying all text lines of the source file to the linked list, **file2sm** appends an EOF line to the linked list, containing the text "\*\*\* End of the file \*\*\*", and prints a brief performance report:

```
        Processing I<lineCount> lines per second.
```

Then it reopens the source file and starts appending the file's text lines to the linked list again.

## EXIT STATUS

- "0"

  **file2sm** 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 diagnostic messages describing the cause of the error; correct problem and rerun.

- Can't create shared memory list.

  smlist error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

- Can't create semaphore.

  ION system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

- Can't open input file

  Operating system error.  Check errtext, correct problem, and rerun.

- Can't reopen input file

  Operating system error.  Check errtext, correct problem, and rerun.

- Can't read from input file

  Operating system error.  Check errtext, correct problem, and rerun.

- Ran out of memory.

  Nominal behavior.  **sm2file** is not extracting data from the linked list quickly enough to prevent it from growing to consume all memory allocated to the test partition.

## BUGS

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

## SEE ALSO

[*sm2file*(1)](/sm2file/1.md), [*smlist*(3)](/smlist/3.md), [*psm*(3)](/psm/3.md)