Doc bug - RemoveEntryList

The DDK doc for this function says:
“RemoveEntryList sets the forward and backward links
for the entry to each other.”

This doesn’t happen. Flink and Blink are not changed
by this call.

Tested on XP SP2 and 2K3.


Do you Yahoo!?
Declare Yourself - Register online to vote today!
http://vote.yahoo.com

I’m really amazed. This is possibly the most used macro in the whole kernel
:slight_smile:

Maxim Shatskih, Windows DDK MVP
StorageCraft Corporation
xxxxx@storagecraft.com
http://www.storagecraft.com

----- Original Message -----
From: “Randy Cook”
To: “Windows File Systems Devs Interest List”
Sent: Wednesday, October 20, 2004 7:09 PM
Subject: [ntfsd] Doc bug - RemoveEntryList

> The DDK doc for this function says:
> “RemoveEntryList sets the forward and backward links
> for the entry to each other.”
>
> This doesn’t happen. Flink and Blink are not changed
> by this call.
>
> Tested on XP SP2 and 2K3.
>
>
>
> _______________________________
> Do you Yahoo!?
> Declare Yourself - Register online to vote today!
> http://vote.yahoo.com
>
>
> —
> Questions? First check the IFS FAQ at
https://www.osronline.com/article.cfm?id=17
>
> You are currently subscribed to ntfsd as: xxxxx@storagecraft.com
> To unsubscribe send a blank email to xxxxx@lists.osr.com

Amazing perhaps, but it really doesn’t set the links - the DDK docs are
wrong I guess.

Presumably someone decided that it was just too much overhead to always set
the fields - god forbid you’d waste 3 instructions…

-----Original Message-----
From: Maxim S. Shatskih [mailto:xxxxx@storagecraft.com]
Sent: Wednesday, October 20, 2004 4:08 PM
To: Windows File Systems Devs Interest List
Subject: Re: [ntfsd] Doc bug - RemoveEntryList

I’m really amazed. This is possibly the most used macro in the whole
kernel
:slight_smile:

Maxim Shatskih, Windows DDK MVP
StorageCraft Corporation
xxxxx@storagecraft.com
http://www.storagecraft.com

----- Original Message -----
From: “Randy Cook”
To: “Windows File Systems Devs Interest List”
Sent: Wednesday, October 20, 2004 7:09 PM
Subject: [ntfsd] Doc bug - RemoveEntryList

> The DDK doc for this function says:
> “RemoveEntryList sets the forward and backward links
> for the entry to each other.”
>
> This doesn’t happen. Flink and Blink are not changed
> by this call.
>
> Tested on XP SP2 and 2K3.
>
>
>
> _______________________________
> Do you Yahoo!?
> Declare Yourself - Register online to vote today!
> http://vote.yahoo.com
>
>
> —
> Questions? First check the IFS FAQ at
https://www.osronline.com/article.cfm?id=17
>
> You are currently subscribed to ntfsd as: xxxxx@storagecraft.com
> To unsubscribe send a blank email to xxxxx@lists.osr.com


Questions? First check the IFS FAQ at
https://www.osronline.com/article.cfm?id=17

You are currently subscribed to ntfsd as: xxxxx@stratus.com
To unsubscribe send a blank email to xxxxx@lists.osr.com

Thanks - I forwarded this to our doc team. I agree it is a bad doc bug.
In case anyone is wondering, neither do RemoveTailList() nor
RemoveHeadList(). You have to call InitializeListHead() on the removed
entry if you wanted Entry->Flink & Blink point back to the entry.
Ravi

-----Original Message-----
From: xxxxx@lists.osr.com
[mailto:xxxxx@lists.osr.com] On Behalf Of Graham, Simon
Sent: Wednesday, October 20, 2004 3:04 PM
To: Windows File Systems Devs Interest List
Subject: RE: [ntfsd] Doc bug - RemoveEntryList

Amazing perhaps, but it really doesn’t set the links - the DDK docs are
wrong I guess.

Presumably someone decided that it was just too much overhead to always
set the fields - god forbid you’d waste 3 instructions…

-----Original Message-----
From: Maxim S. Shatskih [mailto:xxxxx@storagecraft.com]
Sent: Wednesday, October 20, 2004 4:08 PM
To: Windows File Systems Devs Interest List
Subject: Re: [ntfsd] Doc bug - RemoveEntryList

I’m really amazed. This is possibly the most used macro in the whole
kernel
:slight_smile:

Maxim Shatskih, Windows DDK MVP
StorageCraft Corporation
xxxxx@storagecraft.com
http://www.storagecraft.com

----- Original Message -----
From: “Randy Cook”
To: “Windows File Systems Devs Interest List”
Sent: Wednesday, October 20, 2004 7:09 PM
Subject: [ntfsd] Doc bug - RemoveEntryList

> The DDK doc for this function says:
> “RemoveEntryList sets the forward and backward links
> for the entry to each other.”
>
> This doesn’t happen. Flink and Blink are not changed
> by this call.
>
> Tested on XP SP2 and 2K3.
>
>
>
> _______________________________
> Do you Yahoo!?
> Declare Yourself - Register online to vote today!
> http://vote.yahoo.com
>
>
> —
> Questions? First check the IFS FAQ at
https://www.osronline.com/article.cfm?id=17
>
> You are currently subscribed to ntfsd as: xxxxx@storagecraft.com
> To unsubscribe send a blank email to xxxxx@lists.osr.com


Questions? First check the IFS FAQ at
https://www.osronline.com/article.cfm?id=17

You are currently subscribed to ntfsd as: xxxxx@stratus.com
To unsubscribe send a blank email to xxxxx@lists.osr.com


Questions? First check the IFS FAQ at
https://www.osronline.com/article.cfm?id=17

You are currently subscribed to ntfsd as: xxxxx@windows.microsoft.com
To unsubscribe send a blank email to xxxxx@lists.osr.com