1938dd0a70
* contrib/hbtip/ccgi.prg
* contrib/hbtip/client.prg
* contrib/hbtip/encb64.prg
* contrib/hbtip/encoder.prg
* contrib/hbtip/encqp.prg
* contrib/hbtip/encurl.prg
* contrib/hbtip/ftpcli.prg
* contrib/hbtip/hbtip.hbp
* contrib/hbtip/hbtip.hbx
* contrib/hbtip/httpcli.prg
* contrib/hbtip/log.prg
* contrib/hbtip/mail.prg
* contrib/hbtip/mime.c
* contrib/hbtip/misc.c
* contrib/hbtip/popcli.prg
* contrib/hbtip/sessid.prg
* contrib/hbtip/smtpcli.prg
* contrib/hbtip/thtml.ch
* contrib/hbtip/thtml.prg
* contrib/hbtip/tip.ch
* contrib/hbtip/url.prg
+ contrib/hbtip/base64u.prg
+ contrib/hbtip/mailassy.prg
* contrib/hbtip/sendmail.prg -> [...]/mailsend.prg
+ contrib/hbtip/WARNING.txt
* contrib/hbtip/tests/base64.prg
* contrib/hbtip/tests/dbtohtml.prg
* contrib/hbtip/tests/dnldftp.prg -> [...]/ftp_dl.prg
* contrib/hbtip/tests/ftpadv.prg -> [...]/ftp_adv.prg
+ contrib/hbtip/tests/email.prg
+ contrib/hbtip/tests/ftp_ul.prg
- contrib/hbtip/tests/gmail.hbp
- contrib/hbtip/tests/gmail.prg
* contrib/hbtip/tests/hbmk.hbm
* contrib/hbtip/tests/httpadv.prg -> [...]/http_adv.prg
* contrib/hbtip/tests/httpcli.prg -> [...]/http_cli.prg
+ contrib/hbtip/tests/http_qry.prg
- contrib/hbtip/tests/loadhtml.prg
+ contrib/hbtip/tests/test.prg
+ contrib/hbtip/tests/url.prg
* synced with 3.4 fork by Viktor Szakats
; the only difference is slightly edited WARNING.txt
- contrib/hbtip/credent.prg
% deleted TIPCredentials() class that was never implemented
; changes above come from vast number of commits in 3.4 repository - many
thanks to Viktor Szakats for maintaining
43 lines
2.0 KiB
Plaintext
43 lines
2.0 KiB
Plaintext
WARNING for HBTIP users
|
|
=======================
|
|
|
|
Due to the excessive amount of problem reports and long known (and unfixed)
|
|
problems and due to the non-trivial nature of internet protocols, this document
|
|
_strongly recommends to avoid_ using this library in anything production or
|
|
in fact anything more serious than simple test code for educational purposes.
|
|
Please notice that even if something happens to work in some specific
|
|
scenario, it's highly likely it's not a stable solution, nor is it a secure
|
|
solution.
|
|
|
|
The only reason hbtip hasn't been deleted altogether is compatibility
|
|
with 3.0, xHarbour and existing projects, plus the fact there are still some
|
|
low-level functions that do work fine (tip_MimeType()) or have no better
|
|
replacement yet (tip_MailAssemble()).
|
|
|
|
For internet protocol related tasks, the recommended and supported library
|
|
is _hbcurl_, which is a thin wrapper over libcurl's 'easy' API. libcurl is
|
|
a highly ubiquitious, very stable, actively and professionally developed,
|
|
secure communications library:
|
|
|
|
https://curl.haxx.se/libcurl/c/
|
|
|
|
hbcurl's functionality covers _all_ hbtip protocol classes, and it does offer
|
|
support for several protocols besides these.
|
|
|
|
If you're looking for all required static and dynamic libraries to use hbcurl,
|
|
including OpenSSL and libssh2, both 32 and 64-bit. See this page about feature
|
|
support and other details:
|
|
|
|
https://github.com/vszakats/harbour-deps/
|
|
|
|
Usage examples found on the internet for other languages are most of the time
|
|
directly usable with minor modifications in Harbour. You can find several
|
|
working examples under the hbcurl tests directory as well. Live curl
|
|
command-lines can also be converted into compilable/adaptable API code using
|
|
the `--libcurl <targe-source-file>` curl option.
|
|
|
|
If you opt to use hbtip anyway, and find any problem with it (like very common
|
|
SMTP or FTP incompatibilities with various live servers found on the internet),
|
|
your best bet is to address the problem yourself. Patches of sufficent quality
|
|
will be of course accepted.
|