[cifs-protocol] [REG: 115021812413073] MS-DRSR ExecuteKCCTasks empty
Tarun.Chopra at microsoft.com
Fri Feb 27 17:04:36 MST 2015
Hello Andrew - I had a discussion internally and we have come up with following addition - one in quotes, bold and underscored. Appreciate if you can share your inputs on this addition.
procedure ExecuteKCCTasks(): ULONG
This procedure executes the tasks necessary for maintaining the replication topology between DCs.
"These tasks include activities such as maintenance of kCCFailedLinks and kCCFailedConnections, maintenance of intra- and inter-site connections, and updates of RODC objects (as appropriate). See [MS-ADTS] section 6.2.2 for a full list of these tasks."
If an error occurs, a Windows error code is returned. If successful, the method returns 0.
On Feb 19, 2015, at 6:54 AM, Andrew Bartlett <abartlet at samba.org<mailto:abartlet at samba.org>> wrote:
On Thu, 2015-02-19 at 00:37 +0000, Tarun Chopra wrote:
Hello Andrew -
Thanks for the feedback.
Just below this section 126.96.36.199.1 in section 188.8.131.52, we have provided forward reference to section 6.2.2 of MS-ADTS. In addition, last step of pseudo code provided in section 184.108.40.206 calls into 'ExecuteKCCTasks()' which gives an impression that both sections are linked. Is it sufficient from implementation\clarity point of view to have reference from section 220.127.116.11 only ? If not, we will go ahead and add the reference in section 18.104.22.168.1 too.
22.214.171.124 Server Behavior of the IDL_DRSExecuteKCC Method
........ See [MS-ADTS] section 6.2.2 for more information related to the tasks performed by the KCC upon receipt of an IDL_DRSExecuteKCC request.
I did miss that reference. Thanks.
However, I do think we need a bit more - the transition between
paragraphs and pseudo-code in the docs is always a bit jarring, but it
is particularly so when it is an inter-doc reference to something that
starts with a much more general description. Perhaps fill in
ExecuateKCCTasks with this list from 6.2.2, referencing each of the
tasks by number individually?
??Refresh kCCFailedLinks and kCCFailedConnections.
??Create intra-site connections.
??Create inter-site connections.
??Remove unnecessary connections.
??Remove unnecessary kCCFailedLinks and kCCFailedConnections.
Authentication Developer, Samba Team http://samba.org
Samba Developer, Catalyst IT http://catalyst.net.nz/services/samba
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the cifs-protocol