Blame elf/dl-usage.c

Packit Bot 4fdc41
/* Print usage information and help for ld.so.
Packit Bot 4fdc41
   Copyright (C) 1995-2020 Free Software Foundation, Inc.
Packit Bot 4fdc41
   This file is part of the GNU C Library.
Packit Bot 4fdc41
Packit Bot 4fdc41
   The GNU C Library is free software; you can redistribute it and/or
Packit Bot 4fdc41
   modify it under the terms of the GNU Lesser General Public
Packit Bot 4fdc41
   License as published by the Free Software Foundation; either
Packit Bot 4fdc41
   version 2.1 of the License, or (at your option) any later version.
Packit Bot 4fdc41
Packit Bot 4fdc41
   The GNU C Library is distributed in the hope that it will be useful,
Packit Bot 4fdc41
   but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit Bot 4fdc41
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit Bot 4fdc41
   Lesser General Public License for more details.
Packit Bot 4fdc41
Packit Bot 4fdc41
   You should have received a copy of the GNU Lesser General Public
Packit Bot 4fdc41
   License along with the GNU C Library; if not, see
Packit Bot 4fdc41
   <https://www.gnu.org/licenses/>.  */
Packit Bot 4fdc41
Packit Bot 4fdc41
#include <dl-cache.h>
Packit Bot 4fdc41
#include <dl-main.h>
Packit Bot 4fdc41
#include <ldsodefs.h>
Packit Bot ebaa5c
#include <unistd.h>
Packit Bot 79ca57
#include "version.h"
Packit Bot 4fdc41
Packit Bot 4fdc41
void
Packit Bot ebaa5c
_dl_usage (const char *argv0, const char *wrong_option)
Packit Bot 4fdc41
{
Packit Bot ebaa5c
  if (wrong_option != NULL)
Packit Bot ebaa5c
    _dl_error_printf ("%s: unrecognized option '%s'\n", argv0, wrong_option);
Packit Bot ebaa5c
  else
Packit Bot ebaa5c
    _dl_error_printf ("%s: missing program name\n", argv0);
Packit Bot ebaa5c
  _dl_error_printf ("Try '%s --help' for more information.\n", argv0);
Packit Bot ebaa5c
  _exit (EXIT_FAILURE);
Packit Bot ebaa5c
}
Packit Bot ebaa5c
Packit Bot ebaa5c
void
Packit Bot 79ca57
_dl_version (void)
Packit Bot 79ca57
{
Packit Bot 79ca57
  _dl_printf ("\
Packit Bot 79ca57
ld.so " PKGVERSION RELEASE " release version " VERSION ".\n\
Packit Bot 79ca57
Copyright (C) 2020 Free Software Foundation, Inc.\n\
Packit Bot 79ca57
This is free software; see the source for copying conditions.\n\
Packit Bot 79ca57
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A\n\
Packit Bot 79ca57
PARTICULAR PURPOSE.\n\
Packit Bot 79ca57
");
Packit Bot 79ca57
  _exit (EXIT_SUCCESS);
Packit Bot 79ca57
}
Packit Bot 79ca57
Packit Bot 79ca57
void
Packit Bot ebaa5c
_dl_help (const char *argv0, struct dl_main_state *state)
Packit Bot ebaa5c
{
Packit Bot ebaa5c
  _dl_printf ("\
Packit Bot ebaa5c
Usage: %s [OPTION]... EXECUTABLE-FILE [ARGS-FOR-PROGRAM...]\n\
Packit Bot a60e52
You have invoked 'ld.so', the program interpreter for dynamically-linked\n\
Packit Bot a60e52
ELF programs.  Usually, the program interpreter is invoked automatically\n\
Packit Bot a60e52
when a dynamically-linked executable is started.\n\
Packit Bot a60e52
\n\
Packit Bot a60e52
You may invoke the program interpreter program directly from the command\n\
Packit Bot a60e52
line to load and run an ELF executable file; this is like executing that\n\
Packit Bot a60e52
file itself, but always uses the program interpreter you invoked,\n\
Packit Bot a60e52
instead of the program interpreter specified in the executable file you\n\
Packit Bot a60e52
run.  Invoking the program interpreter directly provides access to\n\
Packit Bot a60e52
additional diagnostics, and changing the dynamic linker behavior without\n\
Packit Bot a60e52
setting environment variables (which would be inherited by subprocesses).\n\
Packit Bot 4fdc41
\n\
Packit Bot 4fdc41
  --list                list all dependencies and how they are resolved\n\
Packit Bot 4fdc41
  --verify              verify that given object really is a dynamically linked\n\
Packit Bot 4fdc41
                        object we can handle\n\
Packit Bot 4fdc41
  --inhibit-cache       Do not use " LD_SO_CACHE "\n\
Packit Bot 4fdc41
  --library-path PATH   use given PATH instead of content of the environment\n\
Packit Bot 4fdc41
                        variable LD_LIBRARY_PATH\n\
Packit Bot 4fdc41
  --inhibit-rpath LIST  ignore RUNPATH and RPATH information in object names\n\
Packit Bot 4fdc41
                        in LIST\n\
Packit Bot 4fdc41
  --audit LIST          use objects named in LIST as auditors\n\
Packit Bot 4fdc41
  --preload LIST        preload objects named in LIST\n\
Packit Bot ebaa5c
  --argv0 STRING        set argv[0] to STRING before running\n\
Packit Bot ebaa5c
  --help                display this help and exit\n\
Packit Bot 79ca57
  --version             output version information and exit\n\
Packit Bot 8369e7
\n\
Packit Bot 8369e7
This program interpreter self-identifies as: " RTLD "\n\
Packit Bot ebaa5c
",
Packit Bot ebaa5c
              argv0);
Packit Bot ebaa5c
  _exit (EXIT_SUCCESS);
Packit Bot 4fdc41
}