KYOPON(1)

NAME
kyopon - manipulate data of Kyocera PHS handset

SYNOPSIS
kyopon [-abdimr] [-f device] [-A file] [-B file] [-D file ...] [-I file] [-M file ...]

DESCRIPTION
The kyopon utility reads and writes the internal storage of Kyocera PHS handsets.

The following options are available:

-a  Read address book from the handset and save it as addressbook.txt.

-b  Read bookmarks from the handset and save them as bookmarks.txt.

-d  Read files from data folder of the handset and save them as Dn.dat, where n is a number starting from 0. The file information (file name, type, and time) is saved as Dn.dat.r.

-f device
    Set the data transfer port to device. You must specify the ‘data transfer port’ of ukyopon(4). The default is /dev/ttyU1.

-i  Read web browser information from the handset and save it as browser.ini. This is useful only for earlier models (AH-K3001V/AH-K3002V). On newer models "..\browser.ini: not found" will be printed.

-m  Read mail (E-Mail and Light mail) files from the handset and save them as Mn.txt (E-Mail) and Ln.txt (Light mail), where n is a number starting from 0.

-r  Read all possible data from the handset. Same as -abdim.

-A file
    Write address book from file to the handset (replace existing address book).

-B file
    Write bookmarks from file to the handset (replace existing bookmarks).

-D file ...
    Write files to data folder of the handset. If corresponding ~ file.r file exists for file, the file name information is read from the .r file (type and time information is ignored). If the named file already exists in the data folder, the file is overwritten.

-I file
    Write web browser information from file to the handset (replace existing information). This is useful only for earlier models (AH-K3001V/AH-K3002V), since newer models place "browser.ini" at different location.

-M file ...
    Write mail files to the handset. The mail files are always added as new ones.

The -D and -M options are mutually exclusive. If both the read options and write options are specified, read operations are processed first and then write operations are processed.

EXAMPLES

Backup all possible data from the handset
        kyopon -r

Write back the saved data to the handset
        kyopon -A addressbook.txt -B bookmarks.txt
        kyopon -D D*.dat
        kyopon -M [LM]*.txt
        kyopon -I browser.ini # earlier models only

SEE ALSO
ukyopon(4)

CAVEATS
This tool might possibly damage the data and/or your PHS handset.

This tool doesn't verify the validity of data to be written. The result of writing ill-formatted or too large data is unknown.

The data formats are not consistent. For example, E-mail is in JIS (ISO-2022-JP) code but Light mail is in Shift_JIS code.

If the name field of a bookmark was empty, the folder number will not read correctly.

Mail files will not written back to the folder where they were.

Reading or writing inline images and other related data which were saved with web pages is impossible.

If the data transfer doesn't work (ex. transfer stops), turn off and on the power of the handset and try again.

COPYRIGHT NOTICE
Copyright (c) 2004 Zoroyoshi.
Copyright (c) 2004 raktajino.
Copyright (c) 2004, 2005 Fujidana.
Copyright (c) 2005-2006, 2008 ITOH Yasufumi.
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1.  Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2.  Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.