Skip to content

NAME

dgr2file - DGR reception test program

SYNOPSIS

dgr2file

DESCRIPTION

dgr2file uses DGR to receive multiple copies of the text of a file transmitted by file2dgr, writing each copy of the file to the current working directory. The name of each file written by dgr2file is file_copy_cycleNbr, where cycleNbr is initially zero and is increased by 1 every time dgr2file closes the file it is currently writing and opens a new one.

Upon receiving a DGR datagram from file2dgr, dgr2file extracts the content of the datagram (either a line of text from the file that is being transmitted by file2dgr or else an EOF string indicating the end of that file). It appends each extracted line of text to the local copy of that file that dgr2file is currently writing. When the extracted datagram content is an EOF string (the ASCII text "*** End of the file ***"), dgr2file closes the file it is writing, increments cycleNbr, opens a new copy of the file for writing, and prints the message "working on cycle cycleNbr."

dgr2file always receives datagrams at port 2101.

EXIT STATUS

  • "0"

    dgr2file has terminated.

FILES

No configuration files are needed.

ENVIRONMENT

No environment variables apply.

DIAGNOSTICS

  • can't open dgr service

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

  • can't open output file

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

  • dgr_receive failed

    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 <https://github.com/nasa-jpl/ION-DTN/issues>

SEE ALSO

file2dgr(1), dgr(3)