Skip to content

Commit c190e32

Browse files
authoredMar 25, 2025··
libdbi repo links (#180)
Added note to several chapters about libdbi repos.
2 parents 472c4f3 + fec4a8d commit c190e32

File tree

6 files changed

+21
-6
lines changed

6 files changed

+21
-6
lines changed
 

‎_data/external_links.yml

+10
Original file line numberDiff line numberDiff line change
@@ -384,6 +384,16 @@ gh-hy:
384384
url: https://github.com/hylang/hy
385385
title: [ "hy" ]
386386

387+
gh-libdbi-master:
388+
id: gh-libdbi-master
389+
url: https://github.com/balabit-deps/libdbi/tree/master
390+
title: [ "libdbi master" ]
391+
392+
gh-libdbi-drivers:
393+
id: gh-libdbi-drivers
394+
url: https://github.com/balabit-deps/libdbi-drivers
395+
title: [ "libdbi drivers" ]
396+
387397
gh-mon-src:
388398
id: gh-mon-src
389399
url: https://github.com/syslog-ng/syslog-ng-incubator/tree/master/modules/monitor-source/
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
**NOTE:** Make sure to access libdbi from the libdbi master and libdbi drivers repositories, dedicated for {{ site.product.short_name }}. Using versions from other sources can cause a malfunction.
2+
{: .notice--info}

‎doc/_admin-guide/030_Installing_syslog-ng/001_Compiling_options.md

+2
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,8 @@ compiling options.
101101
if the libdbi library version 0.9 or newer is installed and
102102
detected).
103103

104+
{% include doc/admin-guide/notes/libdb-driver.md %}
105+
104106
- *\--enable-ssl* Enable SSL support, required for encrypted message
105107
transfer, as well as template functions that calculate hashes and
106108
UUIDs (enabled automatically if the libopenssl library is detected).

‎doc/_dev-guide/chapter_4/section_2/README.md

+4-1
Original file line numberDiff line numberDiff line change
@@ -230,13 +230,16 @@ sudo port install \
230230
> * `bison` is required because the version provided by Apple Developer Tools is incomplete (e.g., missing the `-W` option). The reason bison needs to be installed via a package manager is that the `-W` option is supported only in versions after 2.3.
231231
> * `net-snmp` might also be needed because the options provided by Apple Developer Tools are somewhat incorrect. The reason Net-SNMP might be required from a package manager is that the default `pkg-config` may return incorrect library and include paths.
232232
> * `openssl` - since macOS provides LibreSSL by default, you may need to expand the search path of `pkg-config` to find the newly installed OpenSSL. (This seems to have been an issue only with OpenSSL version 1.1.x.)
233-
> * `libdbi` and `libdbi-drivers` are [[maintained and updated|dev-macos-mod-sup-afsql#dependencies]] in {{ site.product.short_name }} repositories, use the latest master version from there
233+
> * `libdbi` and `libdbi-drivers` are [[maintained and updated|dev-macos-mod-sup-afsql#dependencies]] in {{ site.product.short_name }} repositories, use the latest master version from there. For the repository links, see the note below.
234+
234235
> * `libesmtp` - Homebrew does not have libesmtp package support yet, but you can build it yourself from source or use the MacPorts version
235236
> * `riemann-client` - MacPorts does not have riemann-client package support yet, but you can build it yourself from source or use the HomeBrew version
236237
> * `gcc` - see at [compiler selection](#select-the-compiler)
237238
> * actual state of supported features and the required dependencies can also be found [[here|dev-macos-mod-sup-status]].
238239
{: .notice}
239240

241+
{% include doc/admin-guide/notes/libdb-driver.md %}
242+
240243
### Preparations
241244

242245
#### Using Homebrew

‎doc/_dev-guide/chapter_4/section_2/macos-testing-status/afsql.md

+1-5
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,7 @@ id: dev-macos-mod-sup-afsql
1717

1818
This driver has multilevel dependencies. To compile the driver needs the libdbi and libdbi-drivers packages, which are supported and updated in the OSE forks,`and`should work nicely both on ARM and X86 macOS systems now (tested on macOS 13.3.1 and 12.6.4)
1919

20-
Please do not use the pre-built ones (e.g. 0.9.0 from Homebrew), build from the **master** of the following
21-
{: .notice--info}
22-
23-
* [https://github.com/balabit-deps/libdbi-drivers](https://github.com/balabit-deps/libdbi-drivers)
24-
* [https://github.com/balabit-deps/libdbi](https://github.com/balabit-deps/libdbi)
20+
{% include doc/admin-guide/notes/libdb-driver.md %}
2521

2622
To use a given database system you need the corresponding supporting system-specific packages as well. 
2723

‎doc/_dev-guide/chapter_4/section_3/README.md

+2
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,8 @@ The above mentioned dependencies can be satisfied by compiling every-each libs a
6060
* criterion
6161
* gcc14 - See [below](#packages-note)!
6262

63+
{% include doc/admin-guide/notes/libdb-driver.md %}
64+
6365
This is how it might look like if you start from the ground:
6466

6567
```shell

0 commit comments

Comments
 (0)
Please sign in to comment.