Add documentation and test case for --print-os-abi and --set-os-abi

Signed-off-by: Dmitry Moskalchuk <[email protected]>

Author: dmsck

patchelf.1

@@ -36,6 +36,16 @@ INTERPRETER.
 .IP --print-interpreter
 Prints the ELF interpreter of the executable.
 
+.IP --print-os-abi
+Prints the OS ABI of the executable (EI_OSABI field of an ELF file).
+
+.IP "--set-os-abi ABI"
+Changes the OS ABI of the executable (EI_OSABI field of an ELF file).
+The ABI parameter is pretty flexible. For example, you can specify it
+as a "Linux", "linux", or even "lInUx" - all those names will set EI_OSABI
+field of the ELF header to the value "3", which corresponds to Linux OS ABI.
+The same applies to other ABI names - System V, FreeBSD, Solaris, etc.
+
 .IP --print-soname
 Prints DT_SONAME entry of .dynamic section.
 Raises an error if DT_SONAME doesn't exist.

tests/Makefile.am

@@ -33,6 +33,7 @@ src_TESTS = \
   endianness.sh \
   contiguous-note-sections.sh \
   no-gnu-hash.sh \
+  change-abi.sh \
   grow-file.sh \
   no-dynamic-section.sh \
   args-from-file.sh \

tests/change-abi.sh

@@ -0,0 +1,44 @@
+#! /bin/sh -e
+
+SCRATCH=scratch/$(basename $0 .sh)
+
+rm -rf ${SCRATCH}
+mkdir -p ${SCRATCH}
+
+cp simple-pie ${SCRATCH}/simple-pie
+
+# Save the old OS ABI
+OLDABI=`../src/patchelf --print-os-abi ${SCRATCH}/simple-pie`
+# Ensure it's not empty
+test -n "$OLDABI"
+
+# Change OS ABI and verify it has been changed
+{
+  echo "System V"
+  echo "HP-UX"
+  echo "NetBSD"
+  echo "Linux"
+  echo "GNU Hurd"
+  echo "Solaris"
+  echo "AIX"
+  echo "IRIX"
+  echo "FreeBSD"
+  echo "Tru64"
+  echo "OpenBSD"
+  echo "OpenVMS"
+} | {
+  while IFS="\n" read ABI; do
+    echo "Set OS ABI to '$ABI'..."
+    ../src/patchelf --set-os-abi "$ABI" ${SCRATCH}/simple-pie
+
+    echo "Check is OS ABI is '$ABI'..."
+    NEWABI=`../src/patchelf --print-os-abi ${SCRATCH}/simple-pie`
+    test "$NEWABI" = "$ABI"
+  done
+}
+
+# Reset OS ABI to the saved one
+../src/patchelf --set-os-abi "$OLDABI" ${SCRATCH}/simple-pie
+
+# Verify we still can run the executable
+${SCRATCH}/simple-pie