.TH BITPIM 1 "2007-12-12"
.SH NAME
bitpim \- utility to communicate with many CDMA phones
.SH SYNOPSIS
.B bitpim
[\ \fB-c\fP\ \fIfile\fP | \fB-d\fP\ \fIdir\fP\ ]
[\ \fB-f\fP\ \fImodel\fP\ ]
[\ \fB-p\fP\ \fIdevice\fP\ ]
[\ \fBbitfling\fP\ ]
[\ \fBdebug\fP\ ]
[\ \fIcli-command\fP\ ]
.SH DESCRIPTION
This manual page documents briefly the
.B bitpim
command.
.PP
BitPim allows you to view and manipulate data on many phones from LG,
Samsung, Sanyo, and other manufacturers that use Qualcomm CDMA chips.
Depending on your phone model, you may be able to access the phone
book, the calendar, wallpapers, ring tones, and the filesystem.
.SH OPTIONS
A summary of options is included below.
.TP
\fB-c\fP\ \fIfile\fP
Read configuration from \fIfile\fP.
.TP
\fB-d\fP\ \fIdir\fP
Read configuration from \fIdir\fP\fB/.bitpim\fP.
.TP
\fB-f\fP\ \fImodel\fP
Assume a phone type of \fImodel\fP rather than what the configuration
file specifies.  Particularly useful in CLI mode.
.TP
\fB-p\fP\ \fIdevice\fP
Communicate with the phone via the device ("port") \fIdevice\fP.
.TP
\fBbitfling\fP
Run as \fBbitfling\fP(1).
.TP
\fBdebug\fP
Print debugging information to standard output and standard error.
.TP
\fIcli-command\fP
Interact with the phone's filesystem via a command-line interface.
The command must be a \fBsingle\fP (quoted) argument, and can take any
of the following forms:
.RS
.PD 0
.TP
\fBcli\fP
Bring up an interactive shell, allowing all of the below commands as
well as a few others (\fBcd\fP \fIdir\fP, \fBcdu\fP, \fBexit\fP, and
\fBpwd\fP or equivalently \fBcwd\fP).
.TP
\fBcp\fP \fIsrc [...] destdir\fP
Copy files to, from, or within the phone.
.TP
\fBll\fP \fIdir [...]\fP
Print a detailed listing of the specified phone directory or directories.
.TP
\fBls\fP \fIdir [...]\fP
Print a brief listing of the specified phone directory or directories.
.TP
\fBmkdir\fP \fIdir [...]\fP
Create a directory on the phone.
.TP
\fBrm\fP \fIfile [...]\fP
Remove one or more files from the phone.
.TP
\fBrmdir\fP \fIdir [...]\fP
Remove one or more directories, which must already be empty, from the phone.
.PD
.P
Please note that none of these commands accepts wildcards.  To
indicate that an argument denotes a file or directory on the phone,
you can prefix it with \fBphone:\fP; this is mainly relevant for
\fBcp\fP, which performs phone-to-PC copies unless otherwise directed.
.RE
.SH FILES
.TP
\fB$HOME/.bitpim-files/.bitpim\fP
The default configuration file.
.SH SEE ALSO
.BR bitfling (1),
http://www.bitpim.org/.
.SH AUTHOR
\fBbitpim\fP was primarily written by Roger Binns <rogerb@rogerbinns.com>.
.PP
This manual page was written by Aaron M. Ucko <ucko@debian.org>,
for the Debian project (but may be used by others).