]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/commit
Cleanup: Switch to strlcpy from strncpy
authorRichard Yao <richard.yao@alumni.stonybrook.edu>
Tue, 27 Sep 2022 23:35:29 +0000 (19:35 -0400)
committerGitHub <noreply@github.com>
Tue, 27 Sep 2022 23:35:29 +0000 (16:35 -0700)
commit7584fbe846b4127d5a16c5967a005e8f5c1e7b08
tree75e37df0bbb0660c5cee6b3564a29e77fd04ae3e
parent3ed9d6883bcf3c55f92cdaaa6bf1aee2e6fb4115
Cleanup: Switch to strlcpy from strncpy

Coverity found a bug in `zfs_secpolicy_create_clone()` where it is
possible for us to pass an unterminated string when `zfs_get_parent()`
returns an error. Upon inspection, it is clear that using `strlcpy()`
would have avoided this issue.

Looking at the codebase, there are a number of other uses of `strncpy()`
that are unsafe and even when it is used safely, switching to
`strlcpy()` would make the code more readable. Therefore, we switch all
instances where we use `strncpy()` to use `strlcpy()`.

Unfortunately, we do not portably have access to `strlcpy()` in
tests/zfs-tests/cmd/zfs_diff-socket.c because it does not link to
libspl. Modifying the appropriate Makefile.am to try to link to it
resulted in an error from the naming choice used in the file. Trying to
disable the check on the file did not work on FreeBSD because Clang
ignores `#undef` when a definition is provided by `-Dstrncpy(...)=...`.
We workaround that by explictly including the C file from libspl into
the test. This makes things build correctly everywhere.

We add a deprecation warning to `config/Rules.am` and suppress it on the
remaining `strncpy()` usage. `strlcpy()` is not portably avaliable in
tests/zfs-tests/cmd/zfs_diff-socket.c, so we use `snprintf()` there as a
substitute.

This patch does not tackle the related problem of `strcpy()`, which is
even less safe. Thankfully, a quick inspection found that it is used far
more correctly than strncpy() was used. A quick inspection did not find
any problems with `strcpy()` usage outside of zhack, but it should be
said that I only checked around 90% of them.

Lastly, some of the fields in kstat_t varied in size by 1 depending on
whether they were in userspace or in the kernel. The origin of this
discrepancy appears to be 04a479f7066ccdaa23a6546955303b172f4a6909 where
it was made for no apparent reason. It conflicts with the comment on
KSTAT_STRLEN, so we shrink the kernel field sizes to match the userspace
field sizes.

Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov>
Reviewed-by: Ryan Moeller <ryan@iXsystems.com>
Signed-off-by: Richard Yao <richard.yao@alumni.stonybrook.edu>
Closes #13876
22 files changed:
cmd/zfs/zfs_main.c
cmd/ztest.c
config/Rules.am
include/os/freebsd/spl/sys/kstat.h
include/os/linux/spl/sys/kstat.h
lib/libzfs/libzfs_dataset.c
lib/libzfs/libzfs_diff.c
lib/libzpool/taskq.c
module/os/freebsd/spl/callb.c
module/os/freebsd/zfs/zfs_vfsops.c
module/os/linux/spl/spl-kmem-cache.c
module/os/linux/spl/spl-kstat.c
module/os/linux/spl/spl-thread.c
module/os/linux/spl/spl-zone.c
module/zfs/dsl_dir.c
module/zfs/dsl_prop.c
module/zfs/spa_misc.c
module/zfs/zcp_get.c
module/zfs/zfs_ioctl.c
module/zfs/zio_inject.c
tests/zfs-tests/cmd/draid.c
tests/zfs-tests/cmd/zfs_diff-socket.c