doc/bjdwp/README

   1                                  BJDWP Readme
   2                                 ==============
   3
   4 Introduction
   5 ------------
   6
   7 With bjdwp you can debug with JDB your Java applications on your BlackBerry device.
   8 bjdwp is a wrapper between JDB and the JVM embedded in your device.
   9 bjdwp uses the barry library to comminucate with your device.
  10
  11
  12 Table of contents
  13 -----------------
  14
  15 1. Note
  16
  17 2. Requirements
  18
  19 3. Compilation
  20
  21 4. Usage
  22  4.1 Command line
  23  4.2 Options
  24
  25 5. Status
  26
  27 6. Licence
  28
  29
  30
  31                           ==========================
  32
  33
  34 1. Note
  35 -------
  36
  37 The JDWP application to debug Java applications for BlackBerry is currently being developed
  38 on Linux. This driver can do damages. Use this application only if you know what you are doing.
  39
  40
  41 2. Requirements
  42 ---------------
  43
  44   - Barry and libbarry 0.15 or higher (with JavaDebug mode support)
  45   - cmake
  46
  47
  48 3. Compilation
  49 --------------
  50
  51   $ ./configure
  52   $ make
  53
  54   To run the application, launch the binary in the "bin" directory
  55
  56   $ cd bin
  57   $ ./bjdwp
  58
  59
  60 4. Usage
  61 --------
  62
  63 4.1 Command line
  64
  65   1°) Plug your BlackBerry device
  66
  67   2°) Run bjdwp wrapper
  68
  69     $ bjdwp localhost 8000
  70
  71   3°) Run JDB
  72
  73     $ jdb -connect com.sun.jdi.SocketAttach:hostname=localhost,port=8000
  74
  75
  76 4.2 Options
  77
  78   bjdwp accepts the same options that the tools btool, bjavaloader...
  79
  80     bjdwp [hpPv] <address> <port>
  81
  82      -h        This help\n"
  83      -p pin    PIN of device to talk with\n"
  84                If only one device is plugged in, this flag is optional\n"
  85      -P pass   Simplistic method to specify device password\n"
  86      -v        Dump protocol data during operation\n"
  87
  88
  89 5. Status
  90 ---------
  91
  92   bjdwp isn't usable.
  93
  94
  95 6. Licence
  96 ----------
  97
  98   bjdwp application is distributed under the licence GPL.
  99