Additional revamped libsmbclient documentation

- Ensured that all public functions have documentation in libsmbclient.h
- Reformatted for "proper" indentation
- Re-added temporarily-disabled alternate authentication function capability

Derrell
(This used to be commit 64b7150d92849a1e1e2416b9dcc12fae8d6bea99)

Modified revamp of the libsmbclient interface.

Given the tacit (if that) approval by some people, and clear disapproval by
others for my proposed clean-up and reorganization of libsmbclient, I've come
up with a slightly different approach.  This commit changes back to the
original libsmbclient.h SMBCCTX structure which will maintain ABI
compatibility.  I retain, here, the setter and getter functions which all new
code should use.  Older programs already compiled should continue to work
fine.  Older programs being recompiled will encounter compile-time errors
(intentionally!) so that the code can be corrected to use the setter/getter
interfaces.

Although this doesn't clean up the interface in the way I had wanted, the code
reorganization and requirement for new programs to use the setters and getters
allows future progress to be made on libsmbclient without further muddying up
the interface, while retaining the ABI compatibility that was the big issue
causing disapproval.  I hope that this compromise is adequate.

Derrell
(This used to be commit 56429a3d60b2a48963342f6340b3c01469a892c6)

Initial revamp of the libsmbclient interface.

The libsmbclient interface has suffered from difficulty of improvement and
feature enrichment without causing ABI breakage.  Although there were a number
of issues, the primary ones were:

(a) the user of the library would manually manipulate the context structure
    members, meaning that nothing in the context structure could change other
    than adding stuff at the end;

(b) there were three methods of setting options: setting bits in a flags field
    within the context structure, setting explicit options variables within an
    options structure in the context structure, and by calling the
    smbc_option_set() function;

(c) the authentication callback did not traditionally provide enough
    information to the callee which required adding an option for a callback
    with a different signature, and now there are requests for even more
    information at the callback, requiring yet a third signature and option to
    set it (if we implement that feature).

This commit provides a reorganization of the code which fixes (a) and (b).
The context structure is now entirely opaque, and there are setter and getter
functions for manipulating it.  This makes maintaining ABI consistency much,
much easier.

Additionally, the options setting/getting has been unified into a single
mechanism using smbc_option_set() and smbc_option_get().

Yet to be completed is a refactoring of the authentication callback (c).

The test programs in examples/libsmbclient have been modified (if necessary;
some applications require no changes at all) for the new API and a few have
been minimally tested.

Derrell
(This used to be commit d4b4bae8ded824d06ad5ab0e219f71187ee5c771)

Make sure we are still able to join Windows 2008.

Guenther
(This used to be commit aa9c0f587718f4d647e87b9662acbedba042b9cb)

Revert "Add basic infrastructure for general async requests"

This reverts commit ae254cb61f4b9331755848c47ebc34e90dd80390.
(This used to be commit 030bef7f22f7a73466204b7860f397dbca9f2ab0)

Revert "Add infrastructure to support async SMB requests"

This reverts commit f5356825698a02df2d400b51dd95d1f857c83e81.
(This used to be commit 5f53a62be8a21b8d92ac44b18d202882500356e8)

Revert "Add async cli_pull support"

This reverts commit 844a163458c7585e4306a21ffdae5d08e03d6e4d.
(This used to be commit 5ab1cfda500de07ff3c712442ab2fc74eecc8886)

Revert "Convert cli_read to use cli_pull"

This reverts commit 719527f55e88f0c5fdceda5c807475aba299c79f.
(This used to be commit ac301fada257e2d3b50148109a3d44fa1421b0b4)

Revert "Fix warnings"

This reverts commit 9a966e5593ae4474014aec5d8c68c489ac8ce0c9.
(This used to be commit 413695e8d0d8232a9c35e693f9a4a8009418ede4)

Fix init_registry_data for subkeyless top-level keys.

On a fresh install with no existing registry.tdb, make sure we are able to
create our initial top-level entries.

Michael, Volker, please check.

Guenther
(This used to be commit 956bc602062825493e1c357e2388fee1e5514b50)

Restore 3.0 behaviour with empty /etc/hosts

Jeremy, in 3.0 we allowed get_mydnsdomname and get_mydnsfullname to fail
without filling in anything useful. Worked fine. Without this patch and a empty
/etc/hosts and no DNS configured, session setup would return
NT_STATUS_BAD_NETWORK_NAME. This is confusing at best, BAD_NETWORK_NAME afaik
is only ever returned from tcon normally.

This restores the 3.0 behaviour.

Comments?

Volker
(This used to be commit 2bd3b7d474768f842921945d283eac10da2a1684)

Check the right variable for being NULL
(This used to be commit f2c67803792f1fd3929e922c1f626f8247e08992)

Fix the build w/o ldap.

Guenther
(This used to be commit 5f592d030b7e94331a634e0d625aefc60cfb1f70)

Add gp_get_machine_token().

Guenther
(This used to be commit 2f1bc7ddad97b9137ae4cce696bf4e08f9b7ca20)

Revert "what a wurst."

That commit message was just too silly, this happens to me during interactive
rebase all the time...

This reverts commit ab687104c1371c84c510eca7ef2caad7c21ea8fc.
(This used to be commit a3a1edab0d5ac07d42e64a5a82dd71fe0c3fdfeb)

what a wurst.
(This used to be commit ab687104c1371c84c510eca7ef2caad7c21ea8fc)

Add "registry" Group Policy extension.

Guenther
(This used to be commit 4e93301ca4931908a7d1994be45c57002f8c6fea)

Add Group Policy extension infrastructure.

Guenther
(This used to be commit 6d543b1a1a5a7af98affc9aea2edf650cb476379)

Merge branch 'v3-2-test' of ssh://jra@git.samba.org/data/git/samba into v3-2-test
(This used to be commit e7406822d32d5b36d3706144efbd1eaa7c44cead)

Patch to fix the "Invalid read of size 4" errors. Bug #3617.
Jeremy.
(This used to be commit fa12667ec284fdda45b79cbf6bf548ab0faae34f)

Add infrastructure for reading/storing Group Policy state and control data in the registry.

Guenther
(This used to be commit f673bbd300d972dd7ae2d092b3b1e642ed29cfd2)

Fix warnings
(This used to be commit 9a966e5593ae4474014aec5d8c68c489ac8ce0c9)

Pure cosmetics, trying to get my group policy diff smaller.

Gunther
(This used to be commit d7346e9360ffa97e44fa781293d32c707436193b)

Fix part of bug #3617 from valgrind trace.
"Invalid read of size 1" errors.
Jeremy.
(This used to be commit d954a4954ba8ed6cb2c6074176a6008cfa398dd7)

Eliminate tons of build warnings on non-IPV6 system.

Michael
(This used to be commit ee4810099c2d26a0ebab3c41a95bc6b57921683d)

Revert "make idl: Only compile idl files newer than the output to be generated."

This reverts commit 79c199d16e565eabd9fd971247f8df62689bb92a.

Revert this until pidl is capable of doing decent dependency tracking
itself (importing types from imported idls).

Michael
(This used to be commit 1fb69ad1f5c79dd77f73a5fee266e1e363e6974d)

Revert "Add libnet_join.idl to the IDL files to be processed by "make idl"."

This reverts commit 9b47a7329091b2bfe7cd9b2112ac8fa652ed9f60.

libnet_join.idl should not be processed along with the other idl files
since it should not produce server and client code, just the header.

Michael
(This used to be commit 2967b29f23e04f24a62ea576b0b6c948055689d0)

Rename the 'hidden' variable to 'administrative share'.
(This used to be commit eff3d3bad5a8860b99375cc0be9dc24f3679e416)

Fix linking of smbget when there is no shared library support.

smbget needs libwbclient.

Michael
(This used to be commit 78bc496ecf72b5c2474911302e81a90c488e3070)

Fill in WHATSNEW.txt.

Guenther
(This used to be commit 55e85ccd3ec59afc05b955f1458d9fc655cee752)

Attempt to fix the build
(This used to be commit 364d87a5e41045808ebd28f46c5c0c93bd13a7da)

configure: only build vfs_syncops if dirfd() is available

This hopefully fixes the build on HP-UX.

metze
(This used to be commit 5fb7533e37b6c682e019b1c3515dc6befc8bda09)

configure: Remove lib/repdir.c and related stuff

It was only used in configure, but lib/replace already
has a much better version of it.

metze
(This used to be commit c9b60b75b4763c37cfa63741b4f055e4ea488e92)

Add vfs_aio_fork

This is used for two purposes:

First, I'm using it to test the async I/O code. In the forked process it is
pretty easy to delay a reply for a random amount of time. See the
BUILD_FARM_HACKS snippet.

Second, there are systems around that claim to have Posix AIO but which is
broken. This might be some help for those systems.

Also add tests how to pass file descriptors
(This used to be commit b0e52cecf2009d4c7f29412dadf17910e54e4327)

Fix creation of replacetort.

Forgot to git add Makefile.in before doing git commit --amend
in previous commit...

Michael
(This used to be commit 7cf645cdae8ce17705036951538991b0a9dbefaf)

libreplace: add snprintf.c to test code for getifaddrs - needed on some systems.

Michael
(cherry picked from commit 0aff54a12e20d5e91fcdec7aaec103fb9a371a23)
(This used to be commit 77b7d7c0417e498340d1c9364fbbb8671c175477)

libreplace: ifdef out ip6 code if unsupported.

Michael
(cherry picked from commit 54cc0df4dbf6d63a9b94e1ac6af4ec7f7803bc30)
(This used to be commit 1ff0b616a9cb029040031f797b52112d4973e1eb)

libreplace: fix rep_freeifaddrs to not segfault on NULL input.

Michael
(cherry picked from commit 0cbb87453beb52c6b0bc3a48791f49678f4030c5)
(This used to be commit 34d906ef44d1a5c3452097a9cac438d721fe35c1)

libreplace: fix silly crashbug in getifaddrs_test().

Michael
(cherry picked from commit 523626908d25f974fd1ae6d7306b1d4bc8414162)
(This used to be commit 0906120a6e4fe0eb66f3c3fd99c625b30672cb2b)

libreplace: add missing newline in output of getifaddrs test.

Michael
(cherry picked from commit f8243cfc47c7414bab7f249d0e5d1c85e8ca7d64)
(This used to be commit 3c1843f931b896dd3bb142346ecb44c0fb9202d6)

libreplace: add missing semicolon to getifaddrs.

Michael
(cherry picked from commit 29818a07de826fd687003ff25865d77939ecaa9a)
(This used to be commit 1d906d346ed90b87895772a64c7613324ef8b682)

libreplace: try and fix rep_getifaddrs() for Tru64.

Don't fail when there is no address assigned to the interface.
Put NULL into the ifaddrs structure instead.

Michael
(cherry picked from commit ee170c85e0e76411bd752de5fe51db6940dab929)
(This used to be commit 650cc1da4b4404880389c583dbb07ce86df48576)

libreplace: use the new getifaddrs test also for autoconf.

Michael
(cherry picked from commit a2a506ff0eae2a64ebe2ddbb81a6c2a5fa7fe3da)
(This used to be commit c5932414fdf0b568cbfe6cdefaec41c8afc8ca6b)

libreplace: add extended getifaddrs test that prints out the interfaces.

Michael

cherry-picked from libreplace-part of 9d2bab09aac22c00fe23f1e1265a2dbd0901e9ce
and adapted replacetort creation
(This used to be commit 52d79ad4872a20cf55f31aba97629c2561bfc16c)

Trying to fix libnetapi examples Makefile.in.

Guenther
(This used to be commit 405ef74d7e9ef614ea39b7cfd1d57307d9490545)

libnetjoin: add fallback to level 24 samr setinfo so that libnet can join NT4.

Guenther
(This used to be commit bc2d3d51449831146a9faf6e809e7a91d174659c)

libnetjoin: Trying to avoid confusion between acct_flags, acb_info and
access_desired.

Guenther
(This used to be commit 63894e5c93ef0663fc58bcc191777cd1aca7e21c)

Fix samr querydispinfo w.r.t. lsa_AsciiStringLarge.
Thanks metze for the fix.

Guenther
(This used to be commit dcffb885bc5d16e795b71d95e0790d3d7d70cf3c)

Re-run make idl.

Guenther
(This used to be commit 7d88cb2e8db8789b923d8f9979b5c9f65664d3eb)

samr.idl: windows uses lsa_AsciiStringLarge in QueryDisplayInfo

Tested with nt4 and w2k3.

metze
(This used to be commit 490d0c52bb117561227cbc59a15b15b688814fe2)

lsa.idl: strlen_m*() also for the lsa_AsciiString* versions

We already did this before b994f899b42d294c0418bdc82660a2f7510667d6.

This is needed to handle NULL strings, where strlen() would crash...

Maybe we should add a strlen_a() and strlen_a_term() later...

metze
(This used to be commit c445a17a91827c6c95b3a1cda9b78f5cdd41aa55)

lsa.idl: use strlen_m_term() in lsa_StringLarge to support NULL strings

metze
(This used to be commit d98ac73122d44f3a92531b4ebbe09401652b89c7)

lsa.idl: add lsa_AsciiStringLarge

metze
(This used to be commit bf5da9ea08f28f37aecc0674bd9322f0f0cbd82e)

lsa.idl: don't use ascstr_noterm anymore

metze
(This used to be commit 1937d19623029cc4ac0f2c4b336b6460399fa509)

Remove DomainControllerAddressType which we now have in IDL.

Guenther
(This used to be commit 0a012c12d643e627ea1bad2a2ad6214f78918fa7)

Fix memleak in netsamlogon_cache_get().

Guenther
(This used to be commit b736c77dc6c36dcdb601903fadf0ef7f163052a3)

winbind: use a struct element for WBFLAG_PAM_UNIX_NAME

To not conflict with WBFLAG_PAM_INFO3_TEXT.

This should fix pam_winbind.

metze
(This used to be commit 1b8ed6c0ffb2548442bb7e9d848117ce9b1c65c0)

While we are at it: add _wkssvc_NetrUnjoinDomain2 implementation.

This can be tested with e.g. "netdom remove SAMBAHOST" from windows.

Guenther
(This used to be commit 53121e62ea32ff3a984533dca044b67cf5b2c55b)

Re-enable _wkssvc_NetrJoinDomain2 remote join implementation now that we are ready for it.

"netdom join SAMBAHOST" from a windows workstation nicely demonstrates it.

Guenther
(This used to be commit 3bcaa3582a101abc17f7c21128e01024af877577)

Remove original copy of now redundant join code.

Jerry, I checked this very carefully that nothing got lost. The only thing I need to
re-add still is the normalized DN handling for account precreation in "net ads join".

Guenther
(This used to be commit a5c6347644f2aa138a8e67ffe6c167847df941d0)

libnetjoin: Merge in comments, debugs and missing code from original join code.

Guenther
(This used to be commit 09e6010159cb9c2a5d86861889b8c2a07bd39a8d)

Fix macro name (no 's' in ifr_addr).

Interface detection on Solaris still failing due to items pointed out here:
http://lists.samba.org/archive/samba-technical/2007-November/056701.html
(This used to be commit 37c87acc9d48c1fb5d4806374ca8e992300db1ff)

Only set DEBUGLEVEL to 0 in libnetapi when not set already.

Guenther
(This used to be commit 3ace1601ac5b5d87d6bfd8aa0afe0c75858b6990)

Add some more error handling in libnetjoin.

Guenther
(This used to be commit 892b2bc0cf1692c5707d322d0eb711b8245a3a96)

Use libnetapi_get_error_string() in "net dom" commands.

Guenther
(This used to be commit 58048f0c575d6ac5b770873e308d4a1a9ce68123)

Update WHATSNEW.

Karolin
(This used to be commit 01596c9335f0e7f2fd618e79fe313caf97dbb2f4)

Remove smbmount.

Karolin
(This used to be commit 5fbd98f7065268ae134108310119078ad8f62322)

Add mount.cifs as a wrapper for mount.cifs.

Karolin
(This used to be commit be5ee4999ee8708ec06c1563a62c565a890df622)

Convert cli_read to use cli_pull
(This used to be commit 719527f55e88f0c5fdceda5c807475aba299c79f)

Add async cli_pull support

This is the big (and potentially controversial) one. It took a phone call to
explain to metze what is going on inside cli_pull_read_done, but I would really
like everybody to understand this function. It is a very good and reasonably
complex example of async programming. If we want more asynchronism in s3, this
is what we will have to deal with :-)

Make use of it in the smbclient "get" command.

Volker
(This used to be commit 844a163458c7585e4306a21ffdae5d08e03d6e4d)

Add infrastructure to support async SMB requests
(This used to be commit f5356825698a02df2d400b51dd95d1f857c83e81)

Add basic infrastructure for general async requests
(This used to be commit ae254cb61f4b9331755848c47ebc34e90dd80390)

Fix the build - don't use SMB_TRANS_ENC_GSS without
KRB5.
Jeremy.
(This used to be commit d16c295642c3df49be02440427ded0cd9b4179f5)

Don't define SMB_TRANS_ENC_GSS if we don't have KRB5.
Jeremy.
(This used to be commit 6f2b33f6072629be393f88d4450fa6631ef672f6)

Some fixes for net ads join (uninitialized vars).

Guenther
(This used to be commit 735235e32bf41a7564ce2d585c1dae187b00bf6b)

Use libnet_Join() for "net ads join".

Guenther
(This used to be commit 9a7a2777e4ea1a2b5d7c800af8522b38cf22c511)

Add cli_setup_packet_buf

This is == cli_setup_packet but takes an explicit buffer argument
(This used to be commit f64b46dc278899c3449cfd3dbb614aadcf5614d3)

Make cli_struct a talloc parent
(This used to be commit e69244a5c8c7c6b7c1897adc4b4b1cfdfc7a7999)

Nicen error output in net_ads_leave.

Guenther
(This used to be commit b0d1db95e5d7590f9c67be7bf5cb78adfee16635)

Add WERR_TIME_SKEW to werror mapping tables.

Guenther
(This used to be commit 74767be627d48eb1a8deea3784847159b536a0fb)

Add missing full stops and blank lines.

Karolin
(This used to be commit cd784938b72f4e571f6ae178ed953a341f7d0f63)

Add explicit buf arg to cli_check_sign_mac
(This used to be commit ffc1c8cc03e6bad40ed2be91392074b4f038a1bf)

Add explicit buf arg to cli_encrypt_message and cli_calculate_sign_mac
(This used to be commit db6ae9ed2326e6cd68475375d049084cf1d5a98c)

Re-arrange dns update block during "net ads join" a little.

Guenther
(This used to be commit 5d30e9f9fef98de7764ae53d3cbe659b78ae9fce)

Fix one dsgetdcname call in wkssvc rpc server.

Guenther
(This used to be commit a69b918784b037aa17d2dd88a33bd99930631c9b)

WHATSNEW: Add changes by Andreas Schneider.

Michael
(This used to be commit cfb853e6c2d0f6ef6bca3b5b950bb015603f1c2d)

Remove unused display_ds_domain_controller_info() function.

Guenther
(This used to be commit 24a5098b1c3452b2d7088cab6ecdd1d75810e403)

Add another WHATSNEW
(This used to be commit c6f0ff949b480addfa72cd59a790d673bc40f204)

Let dsgetdcname() return a struct netr_DsRGetDCNameInfo.

Guenther
(This used to be commit b1a4b21f8c35dc23e5c986ebe44d3806055eb39b)

Merge branch 'v3-2-test' of ssh://jra@git.samba.org/data/git/samba into v3-2-test
(This used to be commit 8b0082840535eaca19911bf4c15d4e56297e373f)

Updated comments on the encryption support.
Jeremy.
(This used to be commit ab6a9fad3873a9e4f5945e5d72faabbf42bd4f48)

WHATSNEW: add another change.

Michael
(This used to be commit 9436afad7e73a22a3320995f8a25e65a74a0532b)

WHATSNEW: add two more items to my changes.

Michael
(This used to be commit d8555f09d4240736b0c5fc93cea33285b33531b4)

WHATSNEW: Also merge changes in "Major enhancements" section from v3-2-stable.

Michael
(This used to be commit 1984e91f05ce95eb43d149e66994196718a6ffba)

WHATSNEW: give a new date for the upcoming prerelease.

Michael
(This used to be commit 38d327d51f17cb2be9e5963496c97c6d68be79ef)

WHATSNEW: Fix spacings

Michael
(This used to be commit ac37d607ce799d5dc380a24447768b500a0c64ad)

WHATSNEW: fix a typo and spacings

Michael
(This used to be commit 4c02a60a985285d07ee54bb39de6a7568467c944)

WHATSNEW: Merge additions from v3-2-stable's WHATSNEW. :-}

Michael
(This used to be commit 5d1631bd9bfd79357eb0dc47c3ab0b698696efb4)

WHATSNEW: Move Volker's post pre1 changes to the appropriate section.

Michael
(This used to be commit 8cc0d46c388f5971bf468e6eb607b5e230f9a2dd)

WHATSNEW: adapt section on registry configuration to new facts.

Also add to smb.conf changes.

Michael
(This used to be commit b1a55cd1570d71a015cfeac976fbd1f13c44cc7d)