Blame doc/README.aix

Packit Service c0f7c7
Using BPF:
Packit Service c0f7c7
Packit Service c0f7c7
(1) AIX 4.x's version of BPF is undocumented and somewhat unstandard; the
Packit Service c0f7c7
    current BPF support code includes changes that should work around
Packit Service c0f7c7
    that; it appears to compile and work on at least one AIX 4.3.3
Packit Service c0f7c7
    machine.
Packit Service c0f7c7
Packit Service c0f7c7
    Note that the BPF driver and the "/dev/bpf" devices might not exist
Packit Service c0f7c7
    on your machine; AIX's tcpdump loads the driver and creates the
Packit Service c0f7c7
    devices if they don't already exist.  Our libpcap should do the
Packit Service c0f7c7
    same, and the configure script should detect that it's on an AIX
Packit Service c0f7c7
    system and choose BPF even if the devices aren't there.
Packit Service c0f7c7
Packit Service c0f7c7
    Also note that tcpdump _binary_ compiled on AIX 4 may have a problem
Packit Service c0f7c7
    doing the initial loading of the BPF driver if copied to AIX 5 and
Packit Service c0f7c7
    run there (GH #52). tcpdump binary natively compiled on AIX 5 should
Packit Service c0f7c7
    not have this issue.
Packit Service c0f7c7
Packit Service c0f7c7
(2) If libpcap doesn't compile on your machine when configured to use
Packit Service c0f7c7
    BPF, or if the workarounds fail to make it work correctly, you
Packit Service c0f7c7
    should send to tcpdump-workers@lists.tcpdump.org a detailed bug
Packit Service c0f7c7
    report (if the compile fails, send us the compile error messages;
Packit Service c0f7c7
    if it compiles but fails to work correctly, send us as detailed as
Packit Service c0f7c7
    possible a description of the symptoms, including indications of the
Packit Service c0f7c7
    network link-layer type being wrong or time stamps being wrong).
Packit Service c0f7c7
Packit Service c0f7c7
    If you fix the problems yourself, please submit a patch by forking
Packit Service c0f7c7
    the branch at
Packit Service c0f7c7
Packit Service c0f7c7
	https://github.com/the-tcpdump-group/libpcap/issues
Packit Service c0f7c7
Packit Service c0f7c7
    and issuing a pull request, so we can incorporate the fixes into the
Packit Service c0f7c7
    next release.
Packit Service c0f7c7
Packit Service c0f7c7
    If you don't fix the problems yourself, you can, as a workaround,
Packit Service c0f7c7
    make libpcap use DLPI instead of BPF.
Packit Service c0f7c7
Packit Service c0f7c7
    This can be done by specifying the flag:
Packit Service c0f7c7
Packit Service c0f7c7
       --with-pcap=dlpi
Packit Service c0f7c7
Packit Service c0f7c7
    to the "configure" script for libpcap.
Packit Service c0f7c7
Packit Service c0f7c7
If you use DLPI:
Packit Service c0f7c7
Packit Service c0f7c7
(1) It is a good idea to have the latest version of the DLPI driver on
Packit Service c0f7c7
    your system, since certain versions may be buggy and cause your AIX
Packit Service c0f7c7
    system to crash.  DLPI is included in the fileset bos.rte.tty.  I
Packit Service c0f7c7
    found that the DLPI driver that came with AIX 4.3.2 was buggy, and
Packit Service c0f7c7
    had to upgrade to bos.rte.tty 4.3.2.4:
Packit Service c0f7c7
Packit Service c0f7c7
	    lslpp -l bos.rte.tty
Packit Service c0f7c7
Packit Service c0f7c7
	    bos.rte.tty     4.3.2.4  COMMITTED  Base TTY Support and Commands
Packit Service c0f7c7
Packit Service c0f7c7
    Updates for AIX filesets can be obtained from:
Packit Service c0f7c7
    ftp://service.software.ibm.com/aix/fixes/
Packit Service c0f7c7
Packit Service c0f7c7
    These updates can be installed with the smit program.
Packit Service c0f7c7
Packit Service c0f7c7
(2) After compiling libpcap, you need to make sure that the DLPI driver
Packit Service c0f7c7
    is loaded.  Type:
Packit Service c0f7c7
Packit Service c0f7c7
	    strload -q -d dlpi
Packit Service c0f7c7
Packit Service c0f7c7
    If the result is:
Packit Service c0f7c7
Packit Service c0f7c7
	    dlpi: yes
Packit Service c0f7c7
Packit Service c0f7c7
    then the DLPI driver is loaded correctly.
Packit Service c0f7c7
Packit Service c0f7c7
    If it is:
Packit Service c0f7c7
Packit Service c0f7c7
	    dlpi: no
Packit Service c0f7c7
Packit Service c0f7c7
    Then you need to type:
Packit Service c0f7c7
Packit Service c0f7c7
	    strload -f /etc/dlpi.conf
Packit Service c0f7c7
Packit Service c0f7c7
    Check again with strload -q -d dlpi that the dlpi driver is loaded.
Packit Service c0f7c7
Packit Service c0f7c7
    Alternatively, you can uncomment the lines for DLPI in
Packit Service c0f7c7
    /etc/pse.conf and reboot the machine; this way DLPI will always
Packit Service c0f7c7
    be loaded when you boot your system.
Packit Service c0f7c7
Packit Service c0f7c7
(3) There appears to be a problem in the DLPI code in some versions of
Packit Service c0f7c7
    AIX, causing a warning about DL_PROMISC_MULTI failing; this might
Packit Service c0f7c7
    be responsible for DLPI not being able to capture outgoing packets.