diff mbox series

[3/3] xfs: make sure xfs_db/xfs_quota commands are documented

Message ID 158329000698.2374922.9344618703224232004.stgit@magnolia (mailing list archive)
State New, archived
Headers show
Series fstests: random stuff | expand

Commit Message

Darrick J. Wong March 4, 2020, 2:46 a.m. UTC 
From: Darrick J. Wong <darrick.wong@oracle.com>

Make sure all the xfs_db/xfs_quota commands are documented.

Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
---
 tests/xfs/754     |   57 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 tests/xfs/754.out |    2 ++
 tests/xfs/755     |   53 +++++++++++++++++++++++++++++++++++++++++++++++++
 tests/xfs/755.out |    2 ++
 tests/xfs/group   |    2 ++
 5 files changed, 116 insertions(+)
 create mode 100755 tests/xfs/754
 create mode 100644 tests/xfs/754.out
 create mode 100755 tests/xfs/755
 create mode 100644 tests/xfs/755.out

Comments

Zorro Lang March 6, 2020, 10:06 a.m. UTC | #1 
On Tue, Mar 03, 2020 at 06:46:47PM -0800, Darrick J. Wong wrote:
> From: Darrick J. Wong <darrick.wong@oracle.com>
> 
> Make sure all the xfs_db/xfs_quota commands are documented.
> 
> Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
> ---

The test cases make sense, and looks good to me, although it fails
on most of xfsprogs versions currently. I think someone is fixing
these missed docs, right :)

One thing I noticed that:
  $CAT "$MANPAGE" | egrep -q "^\.B.*$COMMAND"

The "^\.B.*$COMMAND" can match ".B report", but can't match something
likes:
"
.B
limit
"

If we don't recommend this format, we'd be better to change and avoid it in
manual pages.

Reviewd-by: Zorro Lang <zlang@redhat.com>

Thanks,
Zorro

>  tests/xfs/754     |   57 +++++++++++++++++++++++++++++++++++++++++++++++++++++
>  tests/xfs/754.out |    2 ++
>  tests/xfs/755     |   53 +++++++++++++++++++++++++++++++++++++++++++++++++
>  tests/xfs/755.out |    2 ++
>  tests/xfs/group   |    2 ++
>  5 files changed, 116 insertions(+)
>  create mode 100755 tests/xfs/754
>  create mode 100644 tests/xfs/754.out
>  create mode 100755 tests/xfs/755
>  create mode 100644 tests/xfs/755.out
> 
> 
> diff --git a/tests/xfs/754 b/tests/xfs/754
> new file mode 100755
> index 00000000..ba0885be
> --- /dev/null
> +++ b/tests/xfs/754
> @@ -0,0 +1,57 @@
> +#! /bin/bash
> +# SPDX-License-Identifier: GPL-2.0-or-newer
> +# Copyright (c) 2020, Oracle and/or its affiliates.  All Rights Reserved.
> +#
> +# FS QA Test No. 754
> +#
> +# Ensure all xfs_db commands are documented.
> +
> +seq=`basename $0`
> +seqres=$RESULT_DIR/$seq
> +echo "QA output created by $seq"
> +
> +here=`pwd`
> +tmp=/tmp/$$
> +status=1    # failure is the default!
> +trap "_cleanup; exit \$status" 0 1 2 3 15
> +
> +_cleanup()
> +{
> +	cd /
> +	rm -f $tmp.* $file
> +}
> +
> +# get standard environment, filters and checks
> +. ./common/rc
> +
> +# real QA test starts here
> +_supported_fs xfs
> +_supported_os Linux
> +_require_command "$XFS_DB_PROG" "xfs_db"
> +_require_command "$MAN_PROG" man
> +_require_test
> +
> +echo "Silence is golden"
> +
> +MANPAGE=$($MAN_PROG --path xfs_db)
> +
> +case "$MANPAGE" in
> +*.gz|*.z\|*.Z)	CAT=zcat;;
> +*.bz2)		CAT=bzcat;;
> +*.xz)		CAT=xzcat;;
> +*)		CAT=cat;;
> +esac
> +_require_command `which $CAT` $CAT
> +
> +file=$TEST_DIR/xx.$seq
> +truncate -s 128m $file
> +$MKFS_XFS_PROG $file >> /dev/null
> +
> +for COMMAND in `$XFS_DB_PROG -x -c help $file | awk '{print $1}' | grep -v "^Use"`; do
> +  $CAT "$MANPAGE" | egrep -q "^\.B.*$COMMAND" || \
> +	echo "$COMMAND not documented in the xfs_db manpage"
> +done
> +
> +# success, all done
> +status=0
> +exit
> diff --git a/tests/xfs/754.out b/tests/xfs/754.out
> new file mode 100644
> index 00000000..9e7cda82
> --- /dev/null
> +++ b/tests/xfs/754.out
> @@ -0,0 +1,2 @@
> +QA output created by 754
> +Silence is golden
> diff --git a/tests/xfs/755 b/tests/xfs/755
> new file mode 100755
> index 00000000..0e5d85ab
> --- /dev/null
> +++ b/tests/xfs/755
> @@ -0,0 +1,53 @@
> +#! /bin/bash
> +# SPDX-License-Identifier: GPL-2.0-or-newer
> +# Copyright (c) 2020, Oracle and/or its affiliates.  All Rights Reserved.
> +#
> +# FS QA Test No. 755
> +#
> +# Ensure all xfs_quota commands are documented.
> +
> +seq=`basename $0`
> +seqres=$RESULT_DIR/$seq
> +echo "QA output created by $seq"
> +
> +here=`pwd`
> +tmp=/tmp/$$
> +status=1    # failure is the default!
> +trap "_cleanup; exit \$status" 0 1 2 3 15
> +
> +_cleanup()
> +{
> +	cd /
> +	rm -f $tmp.* $file
> +}
> +
> +# get standard environment, filters and checks
> +. ./common/rc
> +
> +# real QA test starts here
> +_supported_fs xfs
> +_supported_os Linux
> +_require_command "$XFS_QUOTA_PROG" "xfs_quota"
> +_require_command "$MAN_PROG" man
> +_require_test
> +
> +echo "Silence is golden"
> +
> +MANPAGE=$($MAN_PROG --path xfs_quota)
> +
> +case "$MANPAGE" in
> +*.gz|*.z\|*.Z)	CAT=zcat;;
> +*.bz2)		CAT=bzcat;;
> +*.xz)		CAT=xzcat;;
> +*)		CAT=cat;;
> +esac
> +_require_command `which $CAT` $CAT
> +
> +for COMMAND in `$XFS_QUOTA_PROG -x -c help $file | awk '{print $1}' | grep -v "^Use"`; do
> +  $CAT "$MANPAGE" | egrep -q "^\.B.*$COMMAND" || \
> +	echo "$COMMAND not documented in the xfs_quota manpage"
> +done
> +
> +# success, all done
> +status=0
> +exit
> diff --git a/tests/xfs/755.out b/tests/xfs/755.out
> new file mode 100644
> index 00000000..7c9ea51c
> --- /dev/null
> +++ b/tests/xfs/755.out
> @@ -0,0 +1,2 @@
> +QA output created by 755
> +Silence is golden
> diff --git a/tests/xfs/group b/tests/xfs/group
> index 522d4bc4..aadbb971 100644
> --- a/tests/xfs/group
> +++ b/tests/xfs/group
> @@ -511,3 +511,5 @@
>  511 auto quick quota
>  512 auto quick acl attr
>  513 auto mount
> +754 auto quick db
> +755 auto quick quota
>
Darrick J. Wong March 6, 2020, 3:41 p.m. UTC | #2 
On Fri, Mar 06, 2020 at 06:06:55PM +0800, Zorro Lang wrote:
> On Tue, Mar 03, 2020 at 06:46:47PM -0800, Darrick J. Wong wrote:
> > From: Darrick J. Wong <darrick.wong@oracle.com>
> > 
> > Make sure all the xfs_db/xfs_quota commands are documented.
> > 
> > Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
> > ---
> 
> The test cases make sense, and looks good to me, although it fails
> on most of xfsprogs versions currently. I think someone is fixing
> these missed docs, right :)

Yes, the missing command documentation should be in 5.5.

> One thing I noticed that:
>   $CAT "$MANPAGE" | egrep -q "^\.B.*$COMMAND"
> 
> The "^\.B.*$COMMAND" can match ".B report", but can't match something
> likes:
> "
> .B
> limit
> "
> 
> If we don't recommend this format, we'd be better to change and avoid it in
> manual pages.

I also fixed that.

> Reviewd-by: Zorro Lang <zlang@redhat.com>

        ^ need an 'e' here...

--D

> 
> Thanks,
> Zorro
> 
> >  tests/xfs/754     |   57 +++++++++++++++++++++++++++++++++++++++++++++++++++++
> >  tests/xfs/754.out |    2 ++
> >  tests/xfs/755     |   53 +++++++++++++++++++++++++++++++++++++++++++++++++
> >  tests/xfs/755.out |    2 ++
> >  tests/xfs/group   |    2 ++
> >  5 files changed, 116 insertions(+)
> >  create mode 100755 tests/xfs/754
> >  create mode 100644 tests/xfs/754.out
> >  create mode 100755 tests/xfs/755
> >  create mode 100644 tests/xfs/755.out
> > 
> > 
> > diff --git a/tests/xfs/754 b/tests/xfs/754
> > new file mode 100755
> > index 00000000..ba0885be
> > --- /dev/null
> > +++ b/tests/xfs/754
> > @@ -0,0 +1,57 @@
> > +#! /bin/bash
> > +# SPDX-License-Identifier: GPL-2.0-or-newer
> > +# Copyright (c) 2020, Oracle and/or its affiliates.  All Rights Reserved.
> > +#
> > +# FS QA Test No. 754
> > +#
> > +# Ensure all xfs_db commands are documented.
> > +
> > +seq=`basename $0`
> > +seqres=$RESULT_DIR/$seq
> > +echo "QA output created by $seq"
> > +
> > +here=`pwd`
> > +tmp=/tmp/$$
> > +status=1    # failure is the default!
> > +trap "_cleanup; exit \$status" 0 1 2 3 15
> > +
> > +_cleanup()
> > +{
> > +	cd /
> > +	rm -f $tmp.* $file
> > +}
> > +
> > +# get standard environment, filters and checks
> > +. ./common/rc
> > +
> > +# real QA test starts here
> > +_supported_fs xfs
> > +_supported_os Linux
> > +_require_command "$XFS_DB_PROG" "xfs_db"
> > +_require_command "$MAN_PROG" man
> > +_require_test
> > +
> > +echo "Silence is golden"
> > +
> > +MANPAGE=$($MAN_PROG --path xfs_db)
> > +
> > +case "$MANPAGE" in
> > +*.gz|*.z\|*.Z)	CAT=zcat;;
> > +*.bz2)		CAT=bzcat;;
> > +*.xz)		CAT=xzcat;;
> > +*)		CAT=cat;;
> > +esac
> > +_require_command `which $CAT` $CAT
> > +
> > +file=$TEST_DIR/xx.$seq
> > +truncate -s 128m $file
> > +$MKFS_XFS_PROG $file >> /dev/null
> > +
> > +for COMMAND in `$XFS_DB_PROG -x -c help $file | awk '{print $1}' | grep -v "^Use"`; do
> > +  $CAT "$MANPAGE" | egrep -q "^\.B.*$COMMAND" || \
> > +	echo "$COMMAND not documented in the xfs_db manpage"
> > +done
> > +
> > +# success, all done
> > +status=0
> > +exit
> > diff --git a/tests/xfs/754.out b/tests/xfs/754.out
> > new file mode 100644
> > index 00000000..9e7cda82
> > --- /dev/null
> > +++ b/tests/xfs/754.out
> > @@ -0,0 +1,2 @@
> > +QA output created by 754
> > +Silence is golden
> > diff --git a/tests/xfs/755 b/tests/xfs/755
> > new file mode 100755
> > index 00000000..0e5d85ab
> > --- /dev/null
> > +++ b/tests/xfs/755
> > @@ -0,0 +1,53 @@
> > +#! /bin/bash
> > +# SPDX-License-Identifier: GPL-2.0-or-newer
> > +# Copyright (c) 2020, Oracle and/or its affiliates.  All Rights Reserved.
> > +#
> > +# FS QA Test No. 755
> > +#
> > +# Ensure all xfs_quota commands are documented.
> > +
> > +seq=`basename $0`
> > +seqres=$RESULT_DIR/$seq
> > +echo "QA output created by $seq"
> > +
> > +here=`pwd`
> > +tmp=/tmp/$$
> > +status=1    # failure is the default!
> > +trap "_cleanup; exit \$status" 0 1 2 3 15
> > +
> > +_cleanup()
> > +{
> > +	cd /
> > +	rm -f $tmp.* $file
> > +}
> > +
> > +# get standard environment, filters and checks
> > +. ./common/rc
> > +
> > +# real QA test starts here
> > +_supported_fs xfs
> > +_supported_os Linux
> > +_require_command "$XFS_QUOTA_PROG" "xfs_quota"
> > +_require_command "$MAN_PROG" man
> > +_require_test
> > +
> > +echo "Silence is golden"
> > +
> > +MANPAGE=$($MAN_PROG --path xfs_quota)
> > +
> > +case "$MANPAGE" in
> > +*.gz|*.z\|*.Z)	CAT=zcat;;
> > +*.bz2)		CAT=bzcat;;
> > +*.xz)		CAT=xzcat;;
> > +*)		CAT=cat;;
> > +esac
> > +_require_command `which $CAT` $CAT
> > +
> > +for COMMAND in `$XFS_QUOTA_PROG -x -c help $file | awk '{print $1}' | grep -v "^Use"`; do
> > +  $CAT "$MANPAGE" | egrep -q "^\.B.*$COMMAND" || \
> > +	echo "$COMMAND not documented in the xfs_quota manpage"
> > +done
> > +
> > +# success, all done
> > +status=0
> > +exit
> > diff --git a/tests/xfs/755.out b/tests/xfs/755.out
> > new file mode 100644
> > index 00000000..7c9ea51c
> > --- /dev/null
> > +++ b/tests/xfs/755.out
> > @@ -0,0 +1,2 @@
> > +QA output created by 755
> > +Silence is golden
> > diff --git a/tests/xfs/group b/tests/xfs/group
> > index 522d4bc4..aadbb971 100644
> > --- a/tests/xfs/group
> > +++ b/tests/xfs/group
> > @@ -511,3 +511,5 @@
> >  511 auto quick quota
> >  512 auto quick acl attr
> >  513 auto mount
> > +754 auto quick db
> > +755 auto quick quota
> > 
>
diff mbox series

Patch

diff --git a/tests/xfs/754 b/tests/xfs/754
new file mode 100755
index 00000000..ba0885be
--- /dev/null
+++ b/tests/xfs/754
@@ -0,0 +1,57 @@ 
+#! /bin/bash
+# SPDX-License-Identifier: GPL-2.0-or-newer
+# Copyright (c) 2020, Oracle and/or its affiliates.  All Rights Reserved.
+#
+# FS QA Test No. 754
+#
+# Ensure all xfs_db commands are documented.
+
+seq=`basename $0`
+seqres=$RESULT_DIR/$seq
+echo "QA output created by $seq"
+
+here=`pwd`
+tmp=/tmp/$$
+status=1    # failure is the default!
+trap "_cleanup; exit \$status" 0 1 2 3 15
+
+_cleanup()
+{
+	cd /
+	rm -f $tmp.* $file
+}
+
+# get standard environment, filters and checks
+. ./common/rc
+
+# real QA test starts here
+_supported_fs xfs
+_supported_os Linux
+_require_command "$XFS_DB_PROG" "xfs_db"
+_require_command "$MAN_PROG" man
+_require_test
+
+echo "Silence is golden"
+
+MANPAGE=$($MAN_PROG --path xfs_db)
+
+case "$MANPAGE" in
+*.gz|*.z\|*.Z)	CAT=zcat;;
+*.bz2)		CAT=bzcat;;
+*.xz)		CAT=xzcat;;
+*)		CAT=cat;;
+esac
+_require_command `which $CAT` $CAT
+
+file=$TEST_DIR/xx.$seq
+truncate -s 128m $file
+$MKFS_XFS_PROG $file >> /dev/null
+
+for COMMAND in `$XFS_DB_PROG -x -c help $file | awk '{print $1}' | grep -v "^Use"`; do
+  $CAT "$MANPAGE" | egrep -q "^\.B.*$COMMAND" || \
+	echo "$COMMAND not documented in the xfs_db manpage"
+done
+
+# success, all done
+status=0
+exit
diff --git a/tests/xfs/754.out b/tests/xfs/754.out
new file mode 100644
index 00000000..9e7cda82
--- /dev/null
+++ b/tests/xfs/754.out
@@ -0,0 +1,2 @@ 
+QA output created by 754
+Silence is golden
diff --git a/tests/xfs/755 b/tests/xfs/755
new file mode 100755
index 00000000..0e5d85ab
--- /dev/null
+++ b/tests/xfs/755
@@ -0,0 +1,53 @@ 
+#! /bin/bash
+# SPDX-License-Identifier: GPL-2.0-or-newer
+# Copyright (c) 2020, Oracle and/or its affiliates.  All Rights Reserved.
+#
+# FS QA Test No. 755
+#
+# Ensure all xfs_quota commands are documented.
+
+seq=`basename $0`
+seqres=$RESULT_DIR/$seq
+echo "QA output created by $seq"
+
+here=`pwd`
+tmp=/tmp/$$
+status=1    # failure is the default!
+trap "_cleanup; exit \$status" 0 1 2 3 15
+
+_cleanup()
+{
+	cd /
+	rm -f $tmp.* $file
+}
+
+# get standard environment, filters and checks
+. ./common/rc
+
+# real QA test starts here
+_supported_fs xfs
+_supported_os Linux
+_require_command "$XFS_QUOTA_PROG" "xfs_quota"
+_require_command "$MAN_PROG" man
+_require_test
+
+echo "Silence is golden"
+
+MANPAGE=$($MAN_PROG --path xfs_quota)
+
+case "$MANPAGE" in
+*.gz|*.z\|*.Z)	CAT=zcat;;
+*.bz2)		CAT=bzcat;;
+*.xz)		CAT=xzcat;;
+*)		CAT=cat;;
+esac
+_require_command `which $CAT` $CAT
+
+for COMMAND in `$XFS_QUOTA_PROG -x -c help $file | awk '{print $1}' | grep -v "^Use"`; do
+  $CAT "$MANPAGE" | egrep -q "^\.B.*$COMMAND" || \
+	echo "$COMMAND not documented in the xfs_quota manpage"
+done
+
+# success, all done
+status=0
+exit
diff --git a/tests/xfs/755.out b/tests/xfs/755.out
new file mode 100644
index 00000000..7c9ea51c
--- /dev/null
+++ b/tests/xfs/755.out
@@ -0,0 +1,2 @@ 
+QA output created by 755
+Silence is golden
diff --git a/tests/xfs/group b/tests/xfs/group
index 522d4bc4..aadbb971 100644
--- a/tests/xfs/group
+++ b/tests/xfs/group
@@ -511,3 +511,5 @@ 
 511 auto quick quota
 512 auto quick acl attr
 513 auto mount
+754 auto quick db
+755 auto quick quota