NAME

       ifp - access iRiver iFP audio devices

SYNOPSIS

       ifp command [arguments ...]

DESCRIPTION

       ifp  lets you manage your music on an iRiver iFP music player acting in "Manager Mode". If
       your player is using "UMS Mode", then you don't need this program; it will appear  as  new
       drive when you plug it in.

       This  manual  page documents the version of ifp included as an example application for the
       libifp library. The interface is intended to mimic the ifp binary found  in  the  ifp-line
       binary package.

       ifp can upload or download files or directories, delete or make directories on the device,
       format the device, or upgrade your firmware.

COMMANDS

       ls [directory]
              List the files and directories on the device. The root directory is /.  Directories
              are preceded with 'd' and other files with 'f'.

       df     Display total and free space on the device.

       upload localfile remotefile
              Copy  the  file named localfile to the iFP device, and name it remotefile. (This is
              like cp.)

       upload localfile remotedir
              Copy the file named localfile to the iFP device, into  remotedir.   (This  is  like
              cp.)

       upload localdir remotedir
              Copy the entire directory localdir to the device, into remotedir.  This copies into
              a subdirectory, so upload foo / puts files from the directory foo info /foo on  the
              device.  (This  is  like  cp -R.) This uploads the entire directory, not just audio
              files.

       put localfile | localdir
              Upload the file or directory to the device, with the same name it has locally. If a
              directory is given, it is put in /.

       download remotefile localfile

       download remotefile localdir

       download remotedir localdir
              Like  upload,  but copies from the iFP device to your system. Some proprietary file
              types may not be downloaded.

       get remotefile | remotedir
              Like put, but copies files or directories from the device to your  current  working
              directory.

       rm [-r] file
              Delete (recursively) a file (or directory) on the device.

       rmdir dir
              Delete an empty directory on the device.

       mkdir dir
              Create a directory on the device.

       battery
              Display battery status of the device.

       typestring
              Display the model number of the device.

       firmversion
              Display the firmware revision currently on the device.

       format Reformat the device's memory. This will delete all your music.

       firmupdate FIRMWARE.HEX
              Upload  the  file FIRMWARE.HEX as new firmware for the device. This will not delete
              your music, but may have many other detrimental effects.  Don't turn the device off
              or  unplug  it  while  the  firmware  is  updating, and don't attempt to upload new
              firmware with a low battery.

AUTHORS

       libifp was written by Geoff Oakham, based on ifp by Yamashiro Jun.  This manual  page  was
       written for Debian by Joe Wreschnig <piman@debian.org>, but may be used by others.

                                          May 30th, 2004                                   IFP(1)