summaryrefslogtreecommitdiff
path: root/contrib/man/bt-agent.pod
blob: 270704a9c0ead7c7778f673ee9cffaf59896b3c9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
=head1 NAME

bt-adapter - a bluetooth agent

=head1 SYNOPSIS

bt-agent [OPTION...]

Help Options:
  -h, --help

Application Options:
  -c, --capability=<capability>
  -p, --pin
  -d, --daemon

=head1 DESCRIPTION

This interactive utility is used to manage incoming Bluetooth requests
(eg. request of pincode, request of authorize a connection/service request, etc).

=head1 OPTIONS

B<-h, --help>
    Show help

B<-c, --capability E<lt>capabilityE<gt>>
    Specify the input and output capabilities of the agent.
    `capability` can be one of:
        DisplayOnly
        DisplayYesNo (default)
        KeyboardOnly
        NoInputNoOutput
    (if this option does not defined - `DisplayYesNo' will be used)

B<-p, --pin E<lt>file path<gt>>
    Use a file that holds a list of authorization codes for each device by name or mac address.
    The contents of the file should be in this format:
        AA:BB:CC:DD:EE:FF    123456    
        RemoteDeviceName     *         (accept any pin code)
    If a pin file is included, it will check the passkey of the pairing device against the key included in the file. It will automatically authorize the device if the key matches, otherwise it will request the user for manual authorization.

B<-d, --daemon>
    Run the agent as a background process (as a daemon).
    The agent will rely on a pin file and request no manual user authorization. Any devices that attempt to pair without a valid passkey defined in the pin file will be automatically rejected.

=head1 AUTHOR

Alexander Orlenko <zxteam@gmail.com>.

=head1 SEE ALSO

bt-adapter(1) bt-device(1) bt-network(1)