From de7d4e55138ce896ff65f0dad89f58f454108301 Mon Sep 17 00:00:00 2001
From: Pavel Raiskup <praiskup@redhat.com>
Date: Apr 07 2014 08:04:03 +0000
Subject: man: warn users that cpio's default is dangerous


Resolves: #952313
Version: 2.11-26

---

diff --git a/cpio.1 b/cpio.1
index e6be6be..e227c7a 100644
--- a/cpio.1
+++ b/cpio.1
@@ -1,6 +1,24 @@
 .TH CPIO 1L \" -*- nroff -*-
 .SH NAME
 cpio \- copy files to and from archives
+.SH __WARNING__
+.PP
+The cpio utility is considered LEGACY based on POSIX specification.  Users are
+encouraged to use other archiving tools for archive creation.
+
+If you decided to use cpio, you should almost always force cpio to use the
+ustar format in copy-out mode by the -H option (cpio -o -H ustar).  This is
+because the ustar format is well defined in POSIX specification and thus
+readable by wide range of other archiving tools (including tar e.g.).
+
+By default, GNU cpio uses (for historical reasons) the very old binary format
+('bin') which has significant problems nowadays, e.g. with storing big inode
+numbers (see the Red Hat bug #952313).
+
+Note also that these days the modern 'pax' archive format should be considered
+as the default -- but this format is not implemented in GNU cpio.  You should,
+again, consider using other archivers (e.g. 'tar --format=pax').
+
 .SH SYNOPSIS
 \&\fBCopy-out mode\fR
 .PP
diff --git a/cpio.spec b/cpio.spec
index 76e1199..563ee70 100644
--- a/cpio.spec
+++ b/cpio.spec
@@ -1,7 +1,7 @@
 Summary: A GNU archiving program
 Name: cpio
 Version: 2.11
-Release: 25%{?dist}
+Release: 26%{?dist}
 License: GPLv3+
 Group: Applications/Archiving
 URL: http://www.gnu.org/software/cpio/
@@ -116,6 +116,9 @@ fi
 %{_infodir}/*.info*
 
 %changelog
+* Mon Apr 07 2014 Pavel Raiskup <praiskup@redhat.com> - 2.11-26
+- fix manual page to warn users about inode truncation (#952313)
+
 * Tue Nov 12 2013 Pavel Raiskup <praiskup@redhat.com> - 2.11-25
 - fix build for ppc64le (#1029540)