Your message dated Thu, 06 Feb 2025 09:08:49 +0000
with message-id <e1tfxsp-00bxgy...@fasolo.debian.org>
and subject line Bug#1094865: fixed in libselinux 3.8-1
has caused the Debian Bug report #1094865,
regarding getseuserbyname.3: Some remarks and a patch with editorial changes
for this man page
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact ow...@bugs.debian.org
immediately.)
--
1094865: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1094865
Debian Bug Tracking System
Contact ow...@bugs.debian.org with problems
--- Begin Message ---
Package: libselinux1-dev
Version: 3.7-3+b1
Severity: minor
Tags: patch
* What led up to the situation?
Checking for defects with a new version
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z < "man
page"
[Use "groff -e ' $' -e '\\~$' <file>" to find obvious trailing spaces.]
["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).
[The fate of "test-nroff" was decided in groff bug #55941.]
* What was the outcome of this action?
troff:<stdin>:12: warning: trailing space in the line
troff:<stdin>:14: warning: trailing space in the line
troff:<stdin>:20: warning: trailing space in the line
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.12.10-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages libselinux1-dev depends on:
ii libpcre2-dev 10.44-5
ii libselinux1 3.7-3+b1
ii libsepol-dev 3.7-1
libselinux1-dev recommends no packages.
libselinux1-dev suggests no packages.
-- no debconf information
Input file is getseuserbyname.3
Output from "mandoc -T lint getseuserbyname.3": (shortened list)
1 unterminated quoted argument
3 whitespace at end of input line
-.-.
Output from "test-groff -mandoc -t -ww -z getseuserbyname.3": (shortened list)
3 trailing space in the line
-.-.
Remove space characters (whitespace) at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
Number of lines affected is
3
-.-.
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
Line 1, length 93
.TH "getseuserbyname" "3" "29 September 2005" "dwa...@redhat.com" "SELinux API
documentation"
Line 8, length 94
.BI "int getseuserbyname(const char *" linuxuser ", char **" selinuxuser ",
char **" level ");
-.-.
Remove quotes when there is a printable
but no space character between them
and the quotes are not for emphasis (markup),
for example as an argument to a macro.
1:.TH "getseuserbyname" "3" "29 September 2005" "dwa...@redhat.com" "SELinux
API documentation"
2:.SH "NAME"
5:.SH "SYNOPSIS"
10:.SH "DESCRIPTION"
33:.BR selinux "(8)"
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
troff:<stdin>:12: warning: trailing space in the line
troff:<stdin>:14: warning: trailing space in the line
troff:<stdin>:20: warning: trailing space in the line
--- getseuserbyname.3 2025-01-31 20:12:17.161474339 +0000
+++ getseuserbyname.3.new 2025-01-31 20:25:47.682276578 +0000
@@ -1,25 +1,27 @@
-.TH "getseuserbyname" "3" "29 September 2005" "dwa...@redhat.com" "SELinux API
documentation"
-.SH "NAME"
+.TH getseuserbyname 3 "29 September 2005" dwa...@redhat.com \
+"SELinux API documentation"
+.SH NAME
getseuserbyname \- get SELinux username and level for a given Linux username
.
-.SH "SYNOPSIS"
+.SH SYNOPSIS
.B #include <selinux/selinux.h>
.sp
-.BI "int getseuserbyname(const char *" linuxuser ", char **" selinuxuser ",
char **" level ");
+.BI "int getseuserbyname(const char *" linuxuser ", char **" selinuxuser \
+", char **" level );
.
-.SH "DESCRIPTION"
+.SH DESCRIPTION
.BR getseuserbyname ()
-retrieves the SELinux username and security level associated with
+retrieves the SELinux username and security level associated with
a given Linux username. The SELinux username and security level can
-then be passed to other libselinux functions such as
+then be passed to other libselinux functions such as
.BR \%get_ordered_context_list_with_level (3)
and
.BR \%get_default_context_with_level (3).
The returned SELinux username and level should be freed by the caller
-using free.
+using free.
.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
On success, 0 is returned.
On failure, \-1 is returned and
.I errno
Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)
[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>
The same goes for man pages that are used as an input.
For a style guide use
mandoc -T lint
-.-
Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
It should also check its input files for too long (> 80) lines.
This is just a simple quality control measure.
The "autogenerator" may have to be corrected to get a better man page,
the source file may, and any additional file may.
Common defects:
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
Not beginning each input sentence on a new line.
Line length should thus be reduced.
The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.
See man-pages(7), item "semantic newline".
-.-
The difference between the formatted output of the original and patched file
can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -u <out1> <out2>
and for groff, using
\"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - \"
instead of 'nroff -mandoc'
Add the option '-t', if the file contains a table.
Read the output from 'diff -u ...' with 'less -R' or similar.
-.-.
If 'man' (man-db) is used to check the manual for warnings,
the following must be set:
The option \"-warnings=w\"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT=\"-ww -b -z\"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-
--- End Message ---
--- Begin Message ---
Source: libselinux
Source-Version: 3.8-1
Done: Russell Coker <russ...@coker.com.au>
We believe that the bug you reported is fixed in the latest version of
libselinux, which is due to be installed in the Debian FTP archive.
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to 1094...@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Russell Coker <russ...@coker.com.au> (supplier of updated libselinux package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmas...@ftp-master.debian.org)
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512
Format: 1.8
Date: Thu, 06 Feb 2025 15:01:30 +1100
Source: libselinux
Architecture: source
Version: 3.8-1
Distribution: unstable
Urgency: medium
Maintainer: Debian SELinux maintainers <selinux-de...@lists.alioth.debian.org>
Changed-By: Russell Coker <russ...@coker.com.au>
Closes: 1094854 1094856 1094861 1094865 1094886 1094888 1095045 1095046
Changes:
libselinux (3.8-1) unstable; urgency=medium
.
* Added man page cleanups from Bjarni Ingi Gislason:
getcon(3) Closes: #1094854 getexeccon(3) Closes: #1094856
get_ordered_context_list(3) Closes: #1094861
getseuserbyname(3) Closes: #1094865 init_selinuxmnt(3) Closes: #1094886
is_selinux_enabled(3) Closes: #1094888 matchpathcon(3) Closes: #1095045
matchpathcon_checkmatches(3) Closes: #1095046
* Removed patches for the selabel_open() SEGV and the SWIG support as they
were merged upstream
Checksums-Sha1:
bc0642b5411a151b1ccc7826f5b5451a440c2ad7 2990 libselinux_3.8-1.dsc
dd7528224a118c95356c228ad1c8bf86b3a15673 204389 libselinux_3.8.orig.tar.gz
e0fdf1285ac2c8a4ca8e3036eaed46a8d9c84f42 833 libselinux_3.8.orig.tar.gz.asc
28f09d90bf366f636307141d2ed9d7fb30b3578b 47892 libselinux_3.8-1.debian.tar.xz
d326f7bdd8fddfc94a1d14b010c4bcbb4b4c233d 17052 libselinux_3.8-1_amd64.buildinfo
Checksums-Sha256:
71e03585381c56c9d87c9e1d8b3ecf264c9a2a7e0af168ea35061f6d971663ce 2990
libselinux_3.8-1.dsc
0c3756bca047c9270281d7c4dcdecd000b72e38a183c930661eba9690839b541 204389
libselinux_3.8.orig.tar.gz
7f33102d9602cf9b52ee8fdadc76c279abad39d4ac81aebd23564cc52a8a6c36 833
libselinux_3.8.orig.tar.gz.asc
08aa33ad05c74104b42764966e69a94b0d424335634aa717f4b958f61d12ca68 47892
libselinux_3.8-1.debian.tar.xz
d8418edaa305a35f40af6382d37eea8524eaa407c323e9d9bdfb33a230ebe7bf 17052
libselinux_3.8-1_amd64.buildinfo
Files:
cf24df287cf8009f374dc69a5713b539 2990 libs optional libselinux_3.8-1.dsc
af4b7d1b3b2d32d4c1397604d66de76f 204389 libs optional
libselinux_3.8.orig.tar.gz
bcc36dd468d655a38188a19109a441be 833 libs optional
libselinux_3.8.orig.tar.gz.asc
d8d855d3c7a30258e98b5afd1d154364 47892 libs optional
libselinux_3.8-1.debian.tar.xz
d0c5df75a7f1cb06625cef53a515e946 17052 libs optional
libselinux_3.8-1_amd64.buildinfo
-----BEGIN PGP SIGNATURE-----
iQIzBAEBCgAdFiEEn31hncwG9XwCqmbH0UHNMPxLj3kFAmekeJAACgkQ0UHNMPxL
j3kWDA/+JiNgL2fbLtdY1yRcTRwVx1wVK0HNfuPHHVOy/RkDlgYHDN32VQcMwATM
34YQKE1RodTSL0giEqJgVRBrldDK6Cdo4JMIHzbvehKBSW2FGTs9UTPgJLJhtcSh
0vfrarAkjGi0QrOu2S/kYqdJsSIEQt3l3imkRzpg8dn7k7NqiX6pBizIzsvPQ4Qb
Hg+/6x+4KxuLuI83j+UypDH5MQErlBfTER7GXhDxDh2/oJAfLez57pyqwSb/0Q4p
pZQVEOch1gBA+Ll3VVwfDK0RZUTdJS0cavZIMu4DzhePU83ddxtsMgQjPPA+M0CZ
UHNnFMauOrc7JW7HviQl9VvdWNl7sYuVATsLkJJDXzW8xYrSHqhl4zAX8y/ySpPo
NHVC/cQISS5rTIXFGChWr2KvlzjUp8tO/dB/AoAWv2msjR49J3q7SMj/bi5gY413
bxS4ZcpXcHOJKpTNyrqXi5lCThcM0M/1a3x29GhdT18ujzKj8kCBUAz1E3Gg2Cs7
M5FBD+wsGMjOB4jKOdDCszYXo9GCMpjV4xWJF7tUnguSBykO6umLjsZTqzQfCv04
OytEpGYYXNDlYT1VmUg7HuReizzo3CT7aqM/HRA+Sg8OK2lVNHFLxW9lJ7De/wLn
c67P4EsS8vtewc7P1D0f61w1Z06BFwF2tt3NURmWLFIDql25NME=
=hjsb
-----END PGP SIGNATURE-----
pgpN5jc18D_C1.pgp
Description: PGP signature
--- End Message ---
_______________________________________________
SELinux-devel mailing list
SELinux-devel@alioth-lists.debian.net
https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/selinux-devel
