The Tcpdump Group git mirrors - libpcap/blob - doc/README.aix

   1 # Compiling libpcap on AIX
   2
   3 * Autoconf is expected to work everywhere.
   4 * Neither AIX lex nor AIX yacc nor AIX m4 are suitable.
   5
   6 ## AIX 7.1
   7
   8 * libpcap build fails with rpcapd enabled.
   9 * GNU M4 1.4.17 works.
  10 * flex 2.6.4 and GNU Bison 3.5.1 work.
  11 * CMake 3.16.0 works.
  12 * GCC 8.3.0 works, XL C 12.1.0 works.
  13
  14 ## AIX 7.2
  15
  16 * libpcap build fails with rpcapd enabled.
  17 * GNU M4 1.4.17 works.
  18 * flex 2.5.35 and GNU Bison 3.0.4 work.
  19 * GCC 7.2.0 works, XL C 13.1.3 works.
  20
  21 ## Other AIX-related information
  22
  23 Using BPF:
  24
  25 (1) AIX version of BPF is undocumented and somewhat unstandard; the
  26     current BPF support code includes changes that should work around
  27     that; however, it is no longer possible to verify this is the case.
  28
  29     Note that the BPF driver and the "/dev/bpf" devices might not exist
  30     on your machine; AIX's tcpdump loads the driver and creates the
  31     devices if they don't already exist.  Our libpcap should do the
  32     same, and the configure script should detect that it's on an AIX
  33     system and choose BPF even if the devices aren't there.
  34
  35 (2) If libpcap doesn't compile on your machine when configured to use
  36     BPF, or if the workarounds fail to make it work correctly, you
  37     should send to tcpdump-workers@lists.tcpdump.org a detailed bug
  38     report (if the compile fails, send us the compile error messages;
  39     if it compiles but fails to work correctly, send us as detailed as
  40     possible a description of the symptoms, including indications of the
  41     network link-layer type being wrong or time stamps being wrong).
  42
  43     If you fix the problems yourself, please submit a patch by forking
  44     the branch at
  45
  46         https://github.com/the-tcpdump-group/libpcap/tree/master
  47
  48     and issuing a pull request, so we can incorporate the fixes into the
  49     next release.
  50
  51     If you don't fix the problems yourself, you can, as a workaround,
  52     make libpcap use DLPI instead of BPF.
  53
  54     This can be done by specifying the flag:
  55
  56        --with-pcap=dlpi
  57
  58     to the "configure" script for libpcap.
  59
  60 If you use DLPI:
  61
  62 (1) It is a good idea to have the latest version of the DLPI driver on
  63     your system, since certain versions may be buggy and cause your AIX
  64     system to crash.  DLPI is included in the fileset bos.rte.tty.
  65
  66 (2) After compiling libpcap, you need to make sure that the DLPI driver
  67     is loaded.  Type:
  68
  69             strload -q -d dlpi
  70
  71     If the result is:
  72
  73             dlpi: yes
  74
  75     then the DLPI driver is loaded correctly.
  76
  77     If it is:
  78
  79             dlpi: no
  80
  81     Then you need to type:
  82
  83             strload -f /etc/dlpi.conf
  84
  85     Check again with strload -q -d dlpi that the dlpi driver is loaded.
  86
  87     Alternatively, you can uncomment the lines for DLPI in
  88     /etc/pse.conf and reboot the machine; this way DLPI will always
  89     be loaded when you boot your system.
  90
  91 (3) There appears to be a problem in the DLPI code in some versions of
  92     AIX, causing a warning about DL_PROMISC_MULTI failing; this might
  93     be responsible for DLPI not being able to capture outgoing packets.