man7.org > Linux > man-pages

Linux/UNIX system programming training

ascii-xfr(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE WITH MINICOM | AUTHOR | SEE ALSO | COLOPHON 

ASCII-XFR(1)                Linux Users Manual               ASCII-XFR(1)

NAME         top

       ascii-xfr - upload/download files using the ASCII protocol

SYNOPSIS         top

       ascii-xfr -s|-r [-ednv] [-l linedelay] [-c characterdelay]
       filename

DESCRIPTION         top

       Ascii-xfr Transfers files in ASCII mode. This means no flow
       control, no checksumming and no file-name negotiation. It should
       only be used if the remote system doesn't understand anything
       else.

       The ASCII protocol transfers files line-by-line. The EOL (End-Of-
       Line) character is transmitted as CRLF. When receiving, the CR
       character is stripped from the incoming file.  The Control-Z
       (ASCII 26) character signals End-Of-File, if option -e is
       specified (unless you change it to Control-D (ASCII 4) with -d).

       Ascii-xfr reads from stdin when receiving, and sends data on
       stdout when sending. Some form of input or output redirection to
       the modem device is thus needed when downloading or uploading,
       respectively.

OPTIONS         top

       -s     Send a file.

       -r     Receive a file. One of -s or -r must be present.

       -e     Send the End-Of-File character (Control-Z, ASCII 26 by
              default) when uploading has finished.

       -d     Use the Control-D (ASCII 4) as End-Of-File character.

       -n     Do not translate CR to CRLF and vice versa.

       -v     Verbose: show transfer statistics on the stderr output.

       -l milliseconds
              When transmitting, pause for this delay after each line.

       -c milliseconds
              When transmitting, pause for this delay after each
              character.

       file   Name of the file to send or receive. When receiving, any
              existing file by this name will be truncated.

USAGE WITH MINICOM         top

       If you want to call this program from minicom(1), start minicom
       and go to the Options menu. Select File transfer protocols.  Add
       the following lines, for example as protocols I and J.

       I  Ascii    /usr/bin/ascii-xfr -sv   Y   U   N   Y
       J  Ascii    /usr/bin/ascii-xfr -rv   Y   D   N   Y

AUTHOR         top

       Miquel van Smoorenburg, miquels@cistron.nl
       Jukka Lahtinen, walker@netsonic.fi

SEE ALSO         top

       minicom(1)

COLOPHON         top

       This page is part of the minicom (a serial communication program)
       project.  Information about the project can be found at 
       ⟨https://salsa.debian.org/minicom-team/minicom⟩.  If you have a bug
       report for this manual page, send it to adam@lackorzynski.de.
       This page was obtained from the project's upstream Git repository
       ⟨https://salsa.debian.org/minicom-team/minicom⟩ on 2025-08-11.
       (At that time, the date of the most recent commit that was found
       in the repository was 2025-07-16.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                       $Date: 2006-10-28 14:35:59 $          ASCII-XFR(1)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI