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

# file2sdr(1)

SDR data ingestion test program

## NAME

file2sdr - SDR data ingestion test program

## SYNOPSIS

**file2sdr** *configFlags* *fileName*

## DESCRIPTION

**file2sdr** stress-tests SDR data ingestion by repeatedly writing all text lines of the file named *fileName* to one of a series of non-volatile linked lists created in a test SDR data store named "testsdr*configFlags*". By incorporating the data store configuration into the name (e.g., "testsdr14") we make it relatively easy to perform comparative testing on SDR data stores that are identical aside from their configuration settings.

The operation of **file2sdr** is cyclical: a new linked list is created each time the program finishes copying the file's text lines and starts over again.  If you use ^C to terminate **file2sdr** and then restart it, the program resumes operation at the point where it left off.

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

At the end of each cycle **file2sdr** appends a final EOF line to the current linked list, containing the text "\*\*\* End of the file \*\*\*", and prints a brief performance report:

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

## EXIT STATUS

- "0"

  **file2sdr** has terminated.

## FILES

No configuration files are needed.

## ENVIRONMENT

No environment variables apply.

## DIAGNOSTICS

Diagnostic messages produced by **file2sdr** are written to the ION log file *ion.log*.

- Can't use sdr.

  ION system 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.

- SDR transaction failed.

  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.

## BUGS

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

## SEE ALSO

[*sdr2file*(1)](/sdr2file/1.md), [*sdr*(3)](/sdr/3.md)