1  .\"
  2  .\" FreeBSD pkg - a next generation package for the installation and maintenance
  3  .\" of non-core utilities.
  4  .\"
  5  .\" Redistribution and use in source and binary forms, with or without
  6  .\" modification, are permitted provided that the following conditions
  7  .\" are met:
  8  .\" 1. Redistributions of source code must retain the above copyright
  9  .\"    notice, this list of conditions and the following disclaimer.
 10  .\" 2. Redistributions in binary form must reproduce the above copyright
 11  .\"    notice, this list of conditions and the following disclaimer in the
 12  .\"    documentation and/or other materials provided with the distribution.
 13  .\"
 14  .\"
 15  .\"     @(#)pkg.8
 16  .\"
 17  .Dd August 11, 2025
 18  .Dt PKG-SHLIB 8
 19  .Os
 20  .Sh NAME
 21  .Nm "pkg shlib"
 22  .Nd display which installed package provides or requires a shared library
 23  .Sh SYNOPSIS
 24  .Nm
 25  .Op Fl q
 26  .Op Fl PR
 27  .Ar library
 28  .Pp
 29  .Nm
 30  .Op Cm --quiet
 31  .Op Cm --{provides,requires}
 32  .Ar library
 33  .Sh DESCRIPTION
 34  .Nm
 35  is used for displaying the packages that provide
 36  .Ar library
 37  or that require
 38  .Ar library
 39  by containing binaries that link to it.
 40  .Pp
 41  .Ar library
 42  should be of the form
 43  .Li libname.so.0
 44  or
 45  .Li /path/to/libname.so.0 .
 46  In the latter case, everything up to and including the last path
 47  separator is ignored.
 48  .Sh OPTIONS
 49  The following mutually exclusive options are supported by
 50  .Nm :
 51  .Bl -tag -width provides
 52  .It Fl P , Cm --provides
 53  Show only the installed packages which provide the named
 54  .Ar library .
 55  .It Fl R , Cm --requires
 56  Show only the installed packages which require
 57  .Ar library .
 58  .It Fl q , Cm --quiet
 59  Force quiet output.
 60  .El
 61  .Sh ENVIRONMENT
 62  The following environment variables affect the execution of
 63  .Nm .
 64  See
 65  .Xr pkg.conf 5
 66  for further description.
 67  .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 68  .It PKG_DBDIR
 69  .El
 70  .Sh FILES
 71  See
 72  .Xr pkg.conf 5 .
 73  .Sh SEE ALSO
 74  .Xr pkg_create 3 ,
 75  .Xr pkg_printf 3 ,
 76  .Xr pkg_repo_create 3 ,
 77  .Xr pkg_repos 3 ,
 78  .Xr pkg-keywords 5 ,
 79  .Xr pkg-lua-script 5 ,
 80  .Xr pkg-repository 5 ,
 81  .Xr pkg-script 5 ,
 82  .Xr pkg-triggers 5 ,
 83  .Xr pkg.conf 5 ,
 84  .Xr pkg 8 ,
 85  .Xr pkg-add 8 ,
 86  .Xr pkg-alias 8 ,
 87  .Xr pkg-annotate 8 ,
 88  .Xr pkg-audit 8 ,
 89  .Xr pkg-autoremove 8 ,
 90  .Xr pkg-check 8 ,
 91  .Xr pkg-clean 8 ,
 92  .Xr pkg-config 8 ,
 93  .Xr pkg-create 8 ,
 94  .Xr pkg-delete 8 ,
 95  .Xr pkg-fetch 8 ,
 96  .Xr pkg-help 8 ,
 97  .Xr pkg-info 8 ,
 98  .Xr pkg-install 8 ,
 99  .Xr pkg-key 8 ,
100  .Xr pkg-lock 8 ,
101  .Xr pkg-plugins 8 ,
102  .Xr pkg-query 8 ,
103  .Xr pkg-register 8 ,
104  .Xr pkg-repo 8 ,
105  .Xr pkg-repositories 8 ,
106  .Xr pkg-rquery 8 ,
107  .Xr pkg-search 8 ,
108  .Xr pkg-set 8 ,
109  .Xr pkg-shell 8 ,
110  .Xr pkg-ssh 8 ,
111  .Xr pkg-stats 8 ,
112  .Xr pkg-triggers 8 ,
113  .Xr pkg-unregister 8 ,
114  .Xr pkg-update 8 ,
115  .Xr pkg-updating 8 ,
116  .Xr pkg-upgrade 8 ,
117  .Xr pkg-version 8 ,
118  .Xr pkg-which 8