point people at pkg_check

ok jmc@

3 files changed, 36 insertions, 8 deletions

diff --git a/share/man/man7/packages.7 b/share/man/man7/packages.7
index 0745079e936..da562532ff8 100644
--- a/share/man/man7/packages.7
+++ b/share/man/man7/packages.7
@@ -1,4 +1,4 @@
-.\" $OpenBSD: packages.7,v 1.31 2013/01/09 01:59:16 rpe Exp $
+.\" $OpenBSD: packages.7,v 1.32 2013/04/30 18:33:30 espie Exp $
 .\"
 .\" Copyright (c) 2000 Marc Espie
 .\"
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: January 9 2013 $
+.Dd $Mdocdate: April 30 2013 $
 .Dt PACKAGES 7
 .Os
 .Sh NAME
@@ -111,6 +111,14 @@ specific information installs under
 .Pa /usr/local/share/doc/pkg-readmes .
 .Pp
 The current package system has some deliberate design limitations.
+.Ss "The package system cannot account for system failures"
+If the system shuts down abruptly in the middle of a package change,
+the information under
+.Pa /var/db/pkg
+may well be corrupted.
+Use
+.Xr pkg_check
+in case of such problems.
 .Ss "The package system is not aware of shared network installations"
 And thus, it does not handle that situation well.
 For instance, there is no mechanism to mark some files as being shareable
diff --git a/usr.sbin/pkg_add/pkg_add.1 b/usr.sbin/pkg_add/pkg_add.1
index 858e7617f9f..4d5e2f152ad 100644
--- a/usr.sbin/pkg_add/pkg_add.1
+++ b/usr.sbin/pkg_add/pkg_add.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pkg_add.1,v 1.115 2013/02/04 12:07:14 espie Exp $
+.\"	$OpenBSD: pkg_add.1,v 1.116 2013/04/30 18:33:30 espie Exp $
 .\"
 .\" Documentation and design originally from FreeBSD. All the code has
 .\" been rewritten since. We keep the documentation's notice:
@@ -15,7 +15,7 @@
 .\" Jordan K. Hubbard
 .\"
 .\"
-.Dd $Mdocdate: February 4 2013 $
+.Dd $Mdocdate: April 30 2013 $
 .Dt PKG_ADD 1
 .Os
 .Sh NAME
@@ -81,6 +81,15 @@ but see
 .Xr pkg.conf 5
 .Pc .
 .Pp
+.Nm
+relies on the file system information being consistent.
+In case of a system crash,
+.Pa /var/db/pkg
+may become corrupted.
+Use
+.Xr pkg_check 8
+to repair things.
+.Pp
 If a package is digitally signed:
 .Bl -bullet
 .It
@@ -744,7 +753,8 @@ Temporary area where package information files will be extracted, instead of
 .Xr OpenBSD::Intro 3p ,
 .Xr bsd.port.mk 5 ,
 .Xr package 5 ,
-.Xr pkg.conf 5
+.Xr pkg.conf 5 ,
+.Xr pkg_check 8
 .Sh AUTHORS
 .Bl -tag -width indent -compact
 .It "Jordan Hubbard"
diff --git a/usr.sbin/pkg_add/pkg_delete.1 b/usr.sbin/pkg_add/pkg_delete.1
index 8200c8b61f3..44b616960bc 100644
--- a/usr.sbin/pkg_add/pkg_delete.1
+++ b/usr.sbin/pkg_add/pkg_delete.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pkg_delete.1,v 1.47 2012/07/06 12:11:51 espie Exp $
+.\"	$OpenBSD: pkg_delete.1,v 1.48 2013/04/30 18:33:30 espie Exp $
 .\"
 .\" Documentation and design originally from FreeBSD. All the code has
 .\" been rewritten since. We keep the documentation's notice:
@@ -15,7 +15,7 @@
 .\" Jordan K. Hubbard
 .\"
 .\"
-.Dd $Mdocdate: July 6 2012 $
+.Dd $Mdocdate: April 30 2013 $
 .Dt PKG_DELETE 1
 .Os
 .Sh NAME
@@ -59,6 +59,15 @@ but see
 .Pc .
 .Pp
 .Nm
+relies on the file system information being consistent.
+In case of a system crash,
+.Pa /var/db/pkg
+may become corrupted.
+Use
+.Xr pkg_check 8
+to repair things.
+.Pp
+.Nm
 may ask questions in interactive mode, or error out otherwise.
 Interactive mode is the default on a tty, see
 options
@@ -180,7 +189,8 @@ option is specified.
 .Xr pkg_create 1 ,
 .Xr pkg_info 1 ,
 .Xr pkg.conf 5 ,
-.Xr packages-specs 7
+.Xr packages-specs 7 ,
+.Xr pkg_check 8
 .Sh AUTHORS
 .Bl -tag -width indent -compact
 .It "Jordan Hubbard"