CVSDEB.CONF(5)

💖 CVSDEB.CONF 💖

okay bestie, welcome to cvsdeb.conf — the site-wide config file for cvs-buildpackage and all its lil friends. yes it's section 5, yes it's a config file, yes it's iconic. let's get into it 🫶

---

✨ NAME ✨

cvsdeb.conf — the site-wide configuration file for cvs-buildpackage and friends 💅

---

🌸 SYNOPSIS 🌸

/etc/cvsdeb.conf

---

🦋 DESCRIPTION 🦋

okay so the tea is: /etc/cvsdeb.conf is literally a Bourne Shell snippet that gets included during the package build process. so technically you can put any shell directive in there. which is giving power. which is also giving danger. so like, just make very sure you know what you're doing, okay? 😭

all the variables have reasonable default values, and some of them can maybe be overridden on a per-run or per-individual basis by using environment variables. and literally all the configurable variables can be overridden by options to the scripts themselves. layers on layers, she contains multitudes ✨

so here's how a variable's value can be set, in order:

1. Defaults exist in the rules file. these are the values used if no customization is done at all.
2. Some variables can be set in the config file /etc/cvsdeb.conf. these values override the defaults.
3. Some variables can also be set by setting a corresponding environment variable. these values override the config file and the defaults.
4. Using script command line options. All configurable variables may be set this way, and it overrides all the other methods above. final boss behavior 👑

💜 Predefined variables for cvs-buildpackage 💜

these variables are defined for cvs-buildpackage:

• package — name of the package
• version — the raw version of the package
• sversion — the version number stripped of epochs
• uversion — the upstream version
• tversion — Debian revision number, if any

---

🎀 Configuration File options 🎀

at the moment, the user modifiable variables supported are:

• DEBUG — debugging info, bestie. default value is 0, which means no debugging information is printed. to enable debugging output, set the value to 1.
• conf_forceclean — okay so there are two things CVS may choke on: symbolic links and CVS directories in the source tree. also, there are times when one may not want to honour the upstream .cvsignore files. the conf_forceclean. configuration variable causes the cvs-inject and cvs-upgrade programs to ask whether the offending files should be deleted — and if not, the programs exit with an error message. without this option, the programs just exit with an error message without asking. this can be over ridden by the environment variable CVSDEB_FORCECLEAN.
• conf_rootdir — the root directory is used to set the default value of the cvs-buildpackage work directory, using the package name. the default value is /usr/src/Packages. this should probably not be a sub dir of CVSROOT, since cvs shall refuse to export packages there, and the script shall fail. 💀
• conf_workdir — the cvs-buildpackage work directory. this directory is where the original sources are expected, and this is where the module shall be exported from CVS. if you set this value, the value of the root directory would be ignored. pls note that the cvs-buildpackage work directory referred to here is the scratch directory where this program works, not the directory that the human uses to work in. this should probably not be a sub dir of CVSROOT, since cvs shall refuse to export packages there, and the script shall fail.
• conf_dpkg_options — this is where one may stash -us -uc or whatever to pass on to dpkg-buildpackage. this is different from the other variables in that this is an array variable. these options shall augment (not replace) dpkg-buildpackage options provided on the command line.

bash provides one-dimensional array variables. any variable may be used as an array; the declare builtin will explicitly declare an array. there is no maximum limit on the size of an array, nor any requirement that members be indexed or assigned contiguously. arrays are zero-based.

arrays are assigned to using compound assignments of the form conf_dpkg_options=(value1 ... valueN) or dpkg_options=(value1 ${dpkg_options[@]})

• conf_rootcommand — this is where one specifies the default command to gain root access (usually set to fakeroot, sudo or super). this is also passed along to dpkg-buildpackage.
• conf_buildpackage — sets the name of the builder program invoked, nominally set to dpkg-buildpackage. however, the user may choose to use a different build program, or a wrapper, or even 'chroot /opt/root dpkg-buildpackage' to build the package in a chroot jail, if desired. (obviously, this requires that the Work directory to be a subdirectory of a previously set up chroot jail). one may also hook in pbuilder by setting this variable to 'pdebuild --auto-debsign --buildresult ../'. (again, this requires that pbuilder has been set up correctly). this option can be over ridden by the environment variable CVSDEB_BUILDPACKAGE.
• conf_packageopts — additional arguments to give to conf_buildpackage that shall be appended to dpkg-buildpackage options. use this variable to append to the list of options. this option can be over ridden by the environment variable CVSDEB_PACKAGEOPTS.
• conf_forcetag. — if this is set, then cvs-buildpackage shall call cvs tag -F to ensure that all files are re-tagged correctly.
• conf_prefix=prefix — if this is set, then this prefix is prepended to the package name while looking for the repository. in other word, we append this to CVSROOT while looking for packages. use this to group all your Debian package sources together in a subdirectory in the CVS repository.
• conf_packageintag. — if this is set, then cvs-buildpackage will include the package name and an underscore at the start of every CVS tag it generates or uses.
• conf_cvsmodule — this option sets the CVS module for use with cvs-inject and cvs-upgrade.
• conf_use_changelog — this option tells the cvs-inject and cvs-upgrade commands to incorporate debian changelog entries into the cvs changelog.
• conf_hook_script — this option, if set, should point to a script that should be run just before calling dpkg-buildpackage. ideally, things like this are done using the modules file and programs, but is still provided here for convenience. this is overridden by the environment variable CVSDEB_HOOK.
• conf_get_orig — this option, if set, should contain a command to execute to get the original tarball into the current directory. this can then be used to allow one to get the original file using, for instance, wget or curl. this is overridden by the CVSDEB_GET_ORIG environment variable.
• conf_use_apt — if set to YES, cvs-buildpackage will use apt-get source to retrive the original tarball, if one for the correct upstream version is found in a Sources file known to apt. this is overridden by the CVSDEB_USE_APT environment variable.

---

🌈 Environment Variables 🌈

at the moment, the user modifiable variables supported are:

• CVSDEB_ROOTDIR — if defined, this environment variable will override the value of the root directory set in the configuration file.
• CVSDEB_WORKDIR — if defined, this environment variable will override the value of the cvs-buildpackage work directory set in the configuration file, and would cause the scripts to ignore the root directory, irrespective of where that value was set.
• CVSDEB_MODULE — if defined, this environment variable will override the value of the CVS module set in the configuration file.
• CVSDEB_USE_CHANGELOG — if defined, this environment variable will make cvs-inject and cvs-upgrade programs incorporate entries from the Debian changelog file into the CVS changelog.
• CVSDEB_BUILDPACKAGE. — if defined, this environment variable will override the value of the configuration file variable conf_buildpackage
• CVSDEB_HOOK — over rides the configuration file option conf_hook_script.
• CVSDEB_GET_ORIG — over rides the configuration file option conf_get_orig.

---

🍓 Files 🍓

• system-wide defaults are placed in /etc/cvsdeb.conf. this can be overridden and supplemented by the ~/.cvsdeb.conf file by each user.

---

⭐ SEE ALSO ⭐

cvs-inject(1), cvs-buildpackage(1), cvs-upgrade(1), dpkg-buildpackage(1), cvs(1).

---

💀 BUGS 💀

there are no bugs. any resemblance thereof is delirium. Really. 🙈

---

👑 AUTHOR 👑

this manual page was written by Manoj Srivastava <srivasta@debian.org>, for the Debian GNU/Linux system.

---

and that's the whole vibe bestie — this was the Debian GNU/Linux manual for CVSDEB.CONF(5), dated Feb 21 1998. no cap, she's old but she ATE 💅✨