Chapter 5. Preparing software for RPM packaging

Procedure

1. Back up the original source code:

   $ cp -p cello.c cello.c.orig

   Copy to Clipboard Toggle word wrap

   The -p option preserves mode, ownership, and timestamps.

2. Modify cello.c as needed:

   #include <stdio.h>
   
   int main(void) {
       printf("Hello World from my very first patch!\n");
       return 0;
   }

   Copy to Clipboard Toggle word wrap

3. Generate a patch:

   $ diff -Naur cello.c.orig cello.c

   Copy to Clipboard Toggle word wrap

   --- cello.c.orig        2016-05-26 17:21:30.478523360 -0500
   +++ cello.c     2016-05-27 14:53:20.668588245 -0500
   @@ -1,6 +1,6 @@
    #include<stdio.h>
   
    int main(void){
   -    printf("Hello World!\n");
   +    printf("Hello World from my very first patch!\n");
        return 0;
    }
   \ No newline at end of file

   Copy to Clipboard Toggle word wrap

   Lines that start with + replace the lines that start with -.

   Note

   Using the Naur options with the diff command is recommended because it fits the majority of use cases:

   • -N (--new-file)

     The -N option handles absent files as empty files.

   • -a (--text)

     The -a option treats all files as text. As a result, the diff utility does not ignore the files it classified as binaries.

   • -u (-U NUM or --unified[=NUM])

     The -u option returns output in the form of output NUM (default 3) lines of unified context. This is a compact and an easily readable format commonly used in patch files.

   • -r (--recursive)

     The -r option recursively compares any subdirectories that the diff utility found.

   However, note that in this particular case, only the -u option is necessary.

4. Save the patch to a file:

   $ diff -Naur cello.c.orig cello.c > cello.patch

   Copy to Clipboard Toggle word wrap

5. Restore the original cello.c:

   $ mv cello.c.orig cello.c

   Copy to Clipboard Toggle word wrap
   Important

   You must retain the original cello.c because the RPM package manager uses the original file, not the modified one, when building an RPM package. For more information, see Working with spec files.

Procedure

1. Redirect the patch file to the patch command:

   $ patch < cello.patch

   Copy to Clipboard Toggle word wrap

   patching file cello.c

   Copy to Clipboard Toggle word wrap

2. Check that the contents of cello.c now reflect the desired change:

   $ cat cello.c

   Copy to Clipboard Toggle word wrap

   #include<stdio.h>
   
   int main(void){
       printf("Hello World from my very first patch!\n");
       return 1;
   }

   Copy to Clipboard Toggle word wrap

Verification

1. Build the patched cello.c program:

   $ make

   Copy to Clipboard Toggle word wrap

   gcc -g -o cello cello.c

   Copy to Clipboard Toggle word wrap

2. Run the built cello.c program:

   $ ./cello

   Copy to Clipboard Toggle word wrap

   Hello World from my very first patch!

   Copy to Clipboard Toggle word wrap

Procedure

1. Move all required files into a single directory:

   $ mkdir bello-0.1

   Copy to Clipboard Toggle word wrap

   $ mv ~/bello bello-0.1/

   Copy to Clipboard Toggle word wrap

   $ mv LICENSE bello-0.1/

   Copy to Clipboard Toggle word wrap

2. Create the archive for distribution:

   $ tar -cvzf bello-0.1.tar.gz bello-0.1

   Copy to Clipboard Toggle word wrap

   bello-0.1/
   bello-0.1/LICENSE
   bello-0.1/bello

   Copy to Clipboard Toggle word wrap

3. Move the created archive to the ~/rpmbuild/SOURCES/ directory, which is the default directory where the rpmbuild command stores the files for building packages:

   $ mv bello-0.1.tar.gz ~/rpmbuild/SOURCES/

   Copy to Clipboard Toggle word wrap

Procedure

1. Move all required files into a single directory:

   $ mkdir pello-0.1.1

   Copy to Clipboard Toggle word wrap

   $ mv pello.py pello-0.1.1/

   Copy to Clipboard Toggle word wrap

   $ mv LICENSE pello-0.1.1/

   Copy to Clipboard Toggle word wrap

2. Create the archive for distribution:

   $ tar -cvzf pello-0.1.1.tar.gz pello-0.1.1

   Copy to Clipboard Toggle word wrap

   pello-0.1.1/
   pello-0.1.1/LICENSE
   pello-0.1.1/pello.py

   Copy to Clipboard Toggle word wrap

3. Move the created archive to the ~/rpmbuild/SOURCES/ directory, which is the default directory where the rpmbuild command stores the files for building packages:

   $ mv pello-0.1.1.tar.gz ~/rpmbuild/SOURCES/

   Copy to Clipboard Toggle word wrap

Procedure

1. Move all required files into a single directory:

   $ mkdir cello-1.0

   Copy to Clipboard Toggle word wrap

   $ mv cello.c cello-1.0/

   Copy to Clipboard Toggle word wrap

   $ mv Makefile cello-1.0/

   Copy to Clipboard Toggle word wrap

   $ mv LICENSE cello-1.0/

   Copy to Clipboard Toggle word wrap

2. Create the archive for distribution:

   $ tar -cvzf cello-1.0.tar.gz cello-1.0

   Copy to Clipboard Toggle word wrap

   cello-1.0/
   cello-1.0/Makefile
   cello-1.0/cello.c
   cello-1.0/LICENSE

   Copy to Clipboard Toggle word wrap

3. Move the created archive to the ~/rpmbuild/SOURCES/ directory, which is the default directory where the rpmbuild command stores the files for building packages:

   $ mv cello-1.0.tar.gz ~/rpmbuild/SOURCES/

   Copy to Clipboard Toggle word wrap