man/bjavaloader.1

   1 .\"                                      Hey, EMACS: -*- nroff -*-
   2 .\" First parameter, NAME, should be all caps
   3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
   4 .\" other parameters are allowed: see man(7), man(1)
   5 .TH BJAVALOADER 1 "April 6, 2009"
   6 .\" Please adjust this date whenever revising the manpage.
   7 .\"
   8 .\" Some roff macros, for reference:
   9 .\" .nh        disable hyphenation
  10 .\" .hy        enable hyphenation
  11 .\" .ad l      left justify
  12 .\" .ad b      justify to both left and right margins
  13 .\" .nf        disable filling
  14 .\" .fi        enable filling
  15 .\" .br        insert line break
  16 .\" .sp <n>    insert n+1 empty lines
  17 .\" for manpage-specific macros, see man(7)
  18 .SH NAME
  19 .B bjavaloader
  20 \- Barry Project's program to manage BlackBerry applications
  21 .SH SYNOPSIS
  22 .B bjavaloader [-h][-p pin][-P pass][-v]
  23 .TP
  24 .B bjavaloader dir [-s]
  25 .TP
  26 .B bjavaloader deviceinfo
  27 .TP
  28 .B bjavaloader load <.codfile>
  29 .TP
  30 .B bjavaloader save <module_name>
  31 .TP
  32 .B bjavaloader wipe [-a | -i]
  33 .TP
  34 .B bjavaloader erase [-f] <module_name>
  35 .TP
  36 .B bjavaloader eventlog
  37 .TP
  38 .B bjavaloader cleareventlog
  39 .TP
  40 .B bjavaloader logstacktraces
  41 .TP
  42 .B bjavaloader screenshot <.bmp file>
  43 .TP
  44 .B bjavaloader settime [yyyy-mm-dd HH:MM:SS]
  45 .SH DESCRIPTION
  46 .PP
  47 .B bjavaloader
  48 is a tool for loading, listing, and deleting applications on a BlackBerry
  49 device.  It has a few other features as well, not pertaining to application
  50 management.  The command syntax is intentionally similar to the Windows
  51 program 'javaloader.exe' provided by Research In Motion, in order
  52 to make it easy to use the same build scripts on Linux and Windows.
  53 .SH OPTIONS
  54 .TP
  55 .B \-a
  56 Used with the 'wipe' command to only wipe the applications.
  57 .TP
  58 .B \-i
  59 Used with the 'wipe' command to only wipe the filesystem.
  60 .TP
  61 .B \-f
  62 Used with the 'erase' command to force the erasure of an application
  63 that is currently in use in the device.  Experimental.
  64 .TP
  65 .B \-h
  66 Display a command help summary.
  67 .TP
  68 .B \-s
  69 When using the 'dir' command, list the submodules as well.
  70 .TP
  71 .B \-p pin
  72 Specifies the PIN number of the device with which you wish to communicate,
  73 when multiple devices are connected.
  74 .TP
  75 .B \-P password
  76 A simplistic method to specify the device password.
  77 .TP
  78 .B \-v
  79 Verbose debug output.  This enables dumping of USB bus scanning, as
  80 well as the protocol packets used during communication.
  81
  82 .SH COMMANDS
  83 .TP
  84 .B dir [-s]
  85 Fetch a list of all applications and display them on stdout.  When used with
  86 the -s option, submodules are included, and can take a long time to display.
  87 .TP
  88 .B deviceinfo
  89 Provides information on the handheld.
  90 .TP
  91 .B load <.cod filename> ...
  92 Loads one or more COD application files into the device.
  93 .TP
  94 .B save <module name> ...
  95 Retrieves modules from the handheld and writes them to .cod files with the
  96 same name as the module.  Note that this will overwrite any existing .cod
  97 file in the current directory.
  98 .TP
  99 .B wipe [-a | -i]
 100 Wipes the handheld, removing all data such as messages, contacts, etc.
 101 and/or all .cod files, including OS .cod files.
 102 By default, with no options specified, both applications and data are wiped.
 103 Use the switches to specify only applications or data.
 104 .TP
 105 .B erase [-f] <module name> ...
 106 Delete the specified application module(s).  The module name can be determined
 107 using the 'dir' command.  When used with the -f option, the module is erased
 108 even if in use, and the device will be reset.
 109 .TP
 110 .B eventlog
 111 Retrives the handheld event log and prints it on stdout.
 112 .TP
 113 .B cleareventlog
 114 Clears the handheld event log.
 115 .TP
 116 .B logstacktraces
 117 Dumps the stack traces for all threads into the event log, which can then
 118 be viewed with the 'eventlog' command.
 119 .TP
 120 .B screenshot <.bmp filename>
 121 Capture current screen image and save in BMP format.
 122 .TP
 123 .B settime [yyyy-mm-dd HH:MM:SS]
 124 Sets the time on the handheld to the current time, or the specified time.
 125 If time is given as an argument, the current system timezone is assumed.
 126
 127 .SH AUTHOR
 128 .nh
 129 .B bjavaloader
 130 was initially written for the Barry project by Nicolas Vivien, with
 131 additional contributions from others over time.  This manual page was
 132 written by Chris Frey.
 133 .SH SEE ALSO
 134 .PP
 135 http://www.netdirect.ca/software/packages/barry
 136