man/bjdwp.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 BJDWP 1 "September 29, 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 bjdwp
  20 \- Command line USB Blackberry Java Debug Wire Protocol
  21 .SH SYNOPSIS
  22 .B bjdwp
  23 [\-h][\-p pin][\-P password][\-v] address port
  24
  25 .SH DESCRIPTION
  26 .PP
  27 .B bjdwp
  28 is a program that supports the Java Debug Wire Protocol over USB,
  29 which enables debugging of Java programs directly on your Blackberry.
  30
  31 Support is experimental, and development is focused primarily on the
  32 BlackBerry Storm.
  33
  34 .SH OPTIONS
  35 .TP
  36 .B \-p pin
  37 PIN of device to talk with.  Only needed if you have more than one Blackberry
  38 connected at once.
  39 .TP
  40 .B \-P password
  41 Simplistic method to specify device password.  In a real application, this
  42 would be done using a more secure prompt.
  43 .TP
  44 .B \-v
  45 Dump verbose protocol data during operation.
  46 .TP
  47 .B \-h, \-\-help
  48 Show summary of options.
  49
  50 .SH ARGUMENTS
  51 The following arguments are required, in order to provide a socket where
  52 the JDWP server will listen for connections from the debugger.
  53 .TP
  54 .B address
  55 Most often 'localhost' but can be any IP or hostname on the machine
  56 running bjdwp.
  57 .TP
  58 .B port
  59 Port to listen on.
  60
  61 .SH EXAMPLES
  62 Start the server and the USB connection to the device:
  63
  64         bjdwp localhost 8000
  65
  66 Then start your java debugger:
  67
  68         jdb \-connect com.sun.jdi.SocketAttach:hostname=localhost,port=8000
  69
  70
  71 .SH AUTHOR
  72 .nh
  73 .B bjdwp
  74 was initially written for the Barry project by Nicolas VIVIEN.
  75 This manual page was written by Chris Frey.
  76 .SH SEE ALSO
  77 .PP
  78 http://www.netdirect.ca/software/packages/barry
  79