Submitting Changes to PKI Source Code

Submitting Changes to PKI Source Code#

Select one of the following methods:

Using the PKI Subversion (SVN) Repository#

IMPORTANT: A unified diff has the following format:

diff -U 8 <original file> <modified file>

By default, the unified diff format is the only format provided by Subversion (svn diff), so this method should be followed when using the PKI subversion repository.

See the Coding Style guidelines for more information.

Using the PKI SRPMs#

  • Download the PKI SRPM(s):

    To download the PKI source RPMS, the user must first install the yum utilities:

yum install yum-utils

  • Use yumdownloader to download ALL of the PKI SRPMS (where “{flavor}” equals “dogtag”):

yumdownloader --source osutil pki-ca {flavor}-pki-ca-ui pki-common {flavor}-pki-common-ui\
``  pki-console {flavor}-pki-console-ui pki-java-tools pki-kra {flavor}-pki-kra-ui``
``  pki-manage pki-migrate pki-native-tools pki-ocsp {flavor}-pki-ocsp-ui``
``  pki-ra {flavor}-pki-ra-ui pki-setup pki-silent pki-symkey pki-tks {flavor}-pki-tks-ui pki-tps {flavor}-pki-tps-ui pki-util``
``  ``
``  \ **``NOTE:``\ ``The``\ ``'pki-manage'``\ ``RPM``\ ``has``\ ``been``\ ``'deprecated'``\ ``on``\ ``Fedora``\ ``platforms``\ ``in``\ ``favor``\ ``of``\ ``'yum'``\ ``and``````’yum-utils’!``**
  • Unpackage the SRPM(s):

for rpm in *.rpm
do
``  rpm2cpio ${rpm} | cpio -idumv``
``  gtar -zxvf *.gz``
``  rm *.gz``
done
  • Save a copy of each original file planned on being modified

  • Apply changes as desired to each file

  • Send a unified diff of the changes between the original and modified files to the pki-devel@redhat.com mailing list:

IMPORTANT: A unified diff has the following format:

``diff -U 8 ```` ``

See the Coding Style guidelines for more information.