ldconfig: remove ignored -v (verbose) option

The -v option used to print useful information when operating on a.out
format libraries. After the removal of a.out support, it was accepted
but did not have any effect.

Remove the option and update the man-page.

While here mention the set of historic options that are accepted but
ignored: "-elf", "-s", and "-v".

The FILES section contained outdated information and did not mention
the way library directories of optional ports and packages are
included in the library search path recorded in the hints file.

The description of the "-B" option was incorrect (described a planned
change) for big-endian platforms (powerpc64). These do still default
to big-endian hints files, since the current version of the "pkg"
program expects the hints file to be in native byte-order.

Reviewed by:	kib
MFC after:	1 month
Differential Revision:	https://reviews.freebsd.org/D44139
This commit is contained in:
Stefan Eßer 2024-03-01 16:29:31 +01:00
parent 56ec98a04d
commit 484de86fbe
2 changed files with 23 additions and 16 deletions

View File

@ -41,7 +41,7 @@
.Sh SYNOPSIS
.Nm
.Op Fl 32
.Op Fl BRimrv
.Op Fl BRimr
.Op Fl f Ar hints_file
.Op Ar directory | Ar
.Sh DESCRIPTION
@ -106,8 +106,8 @@ on 64-bit systems that support running 32-bit binaries.
.It Fl elf
Ignored for backwards compatibility.
.It Fl B
Force writing big-endian binary data´to the hints file.
The default is to create little-endian hints files on all architectures.
Force writing big-endian binary data to the hints file.
The default is to create hints files in the native byte-order of the host.
Reading of and merging into hints files preserves the endianness of the
existing hints file.
.It Fl R
@ -131,9 +131,14 @@ on the standard output.
The hints file is not modified.
.Pp
Scan and print all libraries found on the directories list.
.It Fl v
Switch on verbose mode.
.El
.Pp
The historic options
.Fl elf ,
.Fl s ,
and
.Fl v
are accepted but ignored.
.Sh SECURITY
Special care must be taken when loading shared libraries into the address
space of
@ -150,17 +155,19 @@ Thus,
serves to specify the trusted collection of directories from which
shared objects can be safely loaded.
.Sh FILES
.Bl -tag -width /var/run/ld-elf.so.hintsxxx -compact
.Bl -tag -width /usr/local/libdata/ldconfig/* -compact
.It Pa /var/run/ld-elf.so.hints
Standard hints file for the ELF dynamic linker.
.It Pa /etc/ld-elf.so.conf
Conventional configuration file containing directory names for
invocations with
.Fl elf .
.It Pa /var/run/ld-elf32.so.hints
Conventional configuration files containing directory names for
invocations with
Hints file for 32 bit libraries on 64 bit architectures, processed by
ldconfig when invoked with
.Fl 32 .
.It Pa /etc/ld-elf.so.conf
Optional file with names of directories to be included in the standard
hints file when booting to multi-user mode.
.It Pa /usr/local/libdata/ldconfig/*
Additional files with names of directories provided by optional ports
or packages.
.El
.Sh SEE ALSO
.Xr ld 1 ,

View File

@ -57,9 +57,9 @@ main(int argc, char **argv)
{
const char *hints_file;
int c;
bool is_32, justread, merge, rescan, force_be, verbose;
bool is_32, justread, merge, rescan, force_be;
force_be = is_32 = justread = merge = rescan = verbose = false;
force_be = is_32 = justread = merge = rescan = false;
while (argc > 1) {
if (strcmp(argv[1], "-aout") == 0) {
@ -104,7 +104,7 @@ main(int argc, char **argv)
/* was nostd */
break;
case 'v':
verbose = true;
/* was verbose */
break;
default:
usage();
@ -127,7 +127,7 @@ static void
usage(void)
{
fprintf(stderr,
"usage: ldconfig [-32] [-elf] [-BRimrv] [-f hints_file]"
"usage: ldconfig [-32] [-BRimr] [-f hints_file]"
"[directory | file ...]\n");
exit(1);
}