From: Michael Woolweaver <michael@woolweaver.bid>
To: Namjae Jeon <linkinjeon@kernel.org>, Hyunchul Lee <hyc.lee@gmail.com>
Cc: ntfs@lists.linux.dev, linux-kernel@vger.kernel.org,
Michael Woolweaver <michael@woolweaver.bid>
Subject: [PATCH] ntfs: exclude DOS aliases from VFS link count
Date: Wed, 23 Sep 2026 23:17:20 -0500 [thread overview]
Message-ID: <20260924041720.16477-1-michael@woolweaver.bid> (raw)
NTFS counts each $FILE_NAME attribute in the MFT record link_count.
A file with separate Win32 and DOS 8.3 names therefore has a link_count
of two even though the DOS name is an alias and does not represent a
separate VFS hard link.
ntfs_read_locked_inode() copies the MFT link_count directly to i_nlink,
causing stat() to report an extra hard link for files with a separate
DOS alias.
The same distinction is needed when unlinking. ntfs_delete() removes
both the DOS and Win32 $FILE_NAME attributes, decrementing the on-disk
link_count for each, but it must decrement the VFS link count only for
the Win32 name. Otherwise a real hard link can reach i_nlink zero while
another VFS-visible name still exists.
Count non-DOS $FILE_NAME attributes when initializing i_nlink, while
still verifying that the MFT link_count matches the total number of
name attributes. Do not drop i_nlink when ntfs_delete() removes a DOS
alias.
This was reproduced with a file containing separate Win32 and DOS
names. Its MFT link_count was 2 while stat() incorrectly reported 2
links. With the fix, stat() reports 1.
After adding a real POSIX hard link, the MFT contained three
$FILE_NAME attributes while the VFS correctly reported two links.
Removing the Win32/DOS pair left the POSIX hard link with both the MFT
link_count and VFS i_nlink equal to 1.
The fix was runtime-tested with fs/ntfs on a disposable NTFS image and
compile-tested on ntfs-next with W=1. checkpatch.pl reports no issues.
Fixes: 1e9ea7e04472 ("Revert "fs: Remove NTFS classic"")
Assisted-by: LLM
Signed-off-by: Michael Woolweaver <michael@woolweaver.bid>
---
fs/ntfs/inode.c | 77 +++++++++++++++++++++++++++++++++++++++++++++++++
fs/ntfs/namei.c | 5 +++-
2 files changed, 81 insertions(+), 1 deletion(-)
diff --git a/fs/ntfs/inode.c b/fs/ntfs/inode.c
index 9583b2c6c7a2..74a0d9d1e82b 100644
--- a/fs/ntfs/inode.c
+++ b/fs/ntfs/inode.c
@@ -621,6 +621,67 @@ static int ntfs_is_extended_system_file(struct ntfs_attr_search_ctx *ctx)
return 0; /* NO, it is not an extended system file. */
}
+/*
+ * ntfs_count_vfs_links - count VFS-visible hard links
+ * @ctx: initialized attribute search context
+ *
+ * The MFT link count counts all $FILE_NAME attributes. A separate DOS 8.3
+ * name therefore contributes to the on-disk count even though it is an alias
+ * for its Win32 name and does not represent another VFS hard link.
+ *
+ * Return the number of VFS-visible links or -errno on error.
+ */
+static int ntfs_count_vfs_links(struct ntfs_attr_search_ctx *ctx)
+{
+ unsigned int expected, names = 0, links = 0;
+ int err;
+
+ expected = le16_to_cpu(ctx->mrec->link_count);
+ ntfs_attr_reinit_search_ctx(ctx);
+
+ while (!(err = ntfs_attr_lookup(AT_FILE_NAME, NULL, 0, 0, 0, NULL, 0,
+ ctx))) {
+ struct attr_record *attr = ctx->attr;
+ struct file_name_attr *fn;
+ u32 attr_len, value_len;
+ u16 value_off;
+
+ if (unlikely(attr->non_resident))
+ goto corrupt;
+
+ attr_len = le32_to_cpu(attr->length);
+ value_len = le32_to_cpu(attr->data.resident.value_length);
+ value_off = le16_to_cpu(attr->data.resident.value_offset);
+
+ if (unlikely(value_off > attr_len ||
+ value_len > attr_len - value_off ||
+ value_len < offsetof(struct file_name_attr, file_name)))
+ goto corrupt;
+
+ fn = (struct file_name_attr *)((u8 *)attr + value_off);
+ names++;
+ if (fn->file_name_type != FILE_NAME_DOS)
+ links++;
+ }
+
+ if (unlikely(err != -ENOENT))
+ return err;
+
+ if (unlikely(names != expected || !links)) {
+ ntfs_error(ctx->ntfs_ino->vol->sb,
+ "Inode link count doesn't match file name attributes. You should run chkdsk.");
+ return -EIO;
+ }
+
+ ntfs_attr_reinit_search_ctx(ctx);
+ return links;
+
+corrupt:
+ ntfs_error(ctx->ntfs_ino->vol->sb,
+ "Corrupt file name attribute. You should run chkdsk.");
+ return -EIO;
+}
+
static struct lock_class_key ntfs_dir_inval_lock_key;
void ntfs_set_vfs_operations(struct inode *inode, mode_t mode, dev_t dev)
@@ -872,6 +933,22 @@ static int ntfs_read_locked_inode(struct inode *vi)
}
}
skip_attr_list_load:
+ /*
+ * The MFT link count includes separate DOS 8.3 aliases. Once the
+ * attribute list is available, derive the VFS link count from the
+ * $FILE_NAME namespaces instead.
+ */
+ if (!(m->flags & MFT_RECORD_IS_DIRECTORY) && vi->i_ino != FILE_MFT) {
+ int nr_links;
+
+ nr_links = ntfs_count_vfs_links(ctx);
+ if (unlikely(nr_links < 0)) {
+ err = nr_links;
+ goto unm_err_out;
+ }
+ set_nlink(vi, nr_links);
+ }
+
err = ntfs_attr_lookup(AT_EA_INFORMATION, NULL, 0, 0, 0, NULL, 0, ctx);
if (!err) {
NInoSetHasEA(ni);
diff --git a/fs/ntfs/namei.c b/fs/ntfs/namei.c
index 75e201096525..891ee697c0d2 100644
--- a/fs/ntfs/namei.c
+++ b/fs/ntfs/namei.c
@@ -829,6 +829,7 @@ static int ntfs_delete(struct ntfs_inode *ni, struct ntfs_inode *dir_ni,
struct file_name_attr *fn = NULL;
bool looking_for_dos_name = false, looking_for_win32_name = false;
bool case_sensitive_match = true;
+ bool is_dos_name;
int err = 0;
struct mft_record *ni_mrec;
struct super_block *sb;
@@ -932,6 +933,8 @@ static int ntfs_delete(struct ntfs_inode *ni, struct ntfs_inode *dir_ni,
if (err)
goto err_out;
+ is_dos_name = fn->file_name_type == FILE_NAME_DOS;
+
err = ntfs_index_remove(dir_ni, fn, le32_to_cpu(actx->attr->data.resident.value_length));
if (err)
goto err_out;
@@ -942,7 +945,7 @@ static int ntfs_delete(struct ntfs_inode *ni, struct ntfs_inode *dir_ni,
ni_mrec = actx->base_mrec ? actx->base_mrec : actx->mrec;
ni_mrec->link_count = cpu_to_le16(le16_to_cpu(ni_mrec->link_count) - 1);
- if (!S_ISDIR(VFS_I(ni)->i_mode))
+ if (!S_ISDIR(VFS_I(ni)->i_mode) && !is_dos_name)
drop_nlink(VFS_I(ni));
mark_mft_record_dirty(ni);
base-commit: 401898d748fcc8e19ceea1a37ed0de9075fe9ff2
--
2.55.0
next reply other threads:[~2026-09-24 4:17 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-24 4:17 Michael Woolweaver [this message]
2026-09-24 8:27 ` liubaolin
2026-09-24 8:42 ` liubaolin
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260924041720.16477-1-michael@woolweaver.bid \
--to=michael@woolweaver.bid \
--cc=hyc.lee@gmail.com \
--cc=linkinjeon@kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=ntfs@lists.linux.dev \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®