Chapter 3. 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
   --- 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.

1. Redirect the patch file to the patch command:

   $ patch < cello.patch
   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
   #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
   gcc -g -o cello cello.c

   Copy to Clipboard Toggle word wrap

2. Run the built cello.c program:

   $ ./cello
   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
   
   $ mv ~/bello bello-0.1/
   
   $ 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
   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
   
   $ mv pello.py pello-0.1.1/
   
   $ 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
   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
   
   $ mv cello.c cello-1.0/
   
   $ mv Makefile cello-1.0/
   
   $ 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
   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