man/bidentify.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 BIDENTIFY 1 "November 22, 2012"
   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 bidentify
  20 \- Barry Project's program to identify BlackBerry handhelds
  21 .SH SYNOPSIS
  22 .B bidentify
  23 [\-B busname][\-N devname][\-c][\-m][\-s][\-h][\-v]
  24 .SH DESCRIPTION
  25 .PP
  26 .B bidentify
  27 scans the USB system for available BlackBerry devices and probes each
  28 one it finds, then sends the identifying information to stdout in a
  29 computer\(hyfriendly format.
  30 .SH OPTIONS
  31 .TP
  32 .B \-B busname
  33 Specify the USB bus to search for Blackberry devices on.  This is the
  34 first number displayed in the output from the lsusb command, such as 002.
  35 If the busname is numeric on your system, 2 and 002 are equal.  See
  36 also the \-N option, which can be used together with this option
  37 to precisely select the device to work with.
  38 .TP
  39 .B \-N devname
  40 Specify the USB device name.  This is the second number displayed in the
  41 output from the lsusb command, such as 005.  If the device name is numeric
  42 on your system, 5 and 005 are equal.  See also the \-B option.
  43 .TP
  44 .B \-c
  45 If used with the \-m option, ESN numbers will be displayed in both hex and
  46 decimal formats where possible.  If \-m is not used, this option has
  47 no effect.
  48 .TP
  49 .B \-m
  50 Also show the device's ESN / MEID / IMEI number.  This requires desktop
  51 database access, so is an option.  It will only work on devices that have
  52 no password.
  53 .TP
  54 .B \-s
  55 Also show the device's USB serial number.  This is the same serial number
  56 that is available through the lsusb command line tool, and may not always
  57 be what you expect.
  58 .TP
  59 .B \-v
  60 Dump verbose protocol data during operation.
  61 .TP
  62 .B \-h, \-\-help
  63 Show summary of options.
  64
  65
  66 .SH RETURN STATUS
  67 If
  68 .B bidentify
  69 detects a BlackBerry device, but cannot access it for some reason, it
  70 will write an error message to stderr describing the access problem,
  71 and return a count of the number of such failed devices as the error code.
  72 A return code of 0 means there were no BlackBerry devices found that
  73 could not be probed.
  74
  75 In the event of a fatal error, the message will be written to stderr,
  76 with an error code of 1.
  77
  78
  79 .SH AUTHOR
  80 .nh
  81 .B bidentify
  82 is part of the Barry project.
  83 This manual page was written by Chris Frey.
  84 .SH SEE ALSO
  85 .PP
  86 http://www.netdirect.ca/software/packages/barry
  87