CVSup

CVSup-master.FreeBSD.org

Setting up cvpasswd authentication

Note: If you are simply a FreeBSD user who would like to use CVSup to update your sources, this page is NOT for you. Look at the list of public CVSup mirror sites and choose one of them. The sites in the list are open to everybody. They do not require authentication of any kind.

Public mirror sites in the FreeBSD.org domain and FreeBSD committers may have direct access to CVSup-master.FreeBSD.org, subject to the conditions of the access policy. Access is controlled by authentication keys which you must generate. You can use the cvpasswd utility from the CVSup distributions to generate your keys.

First choose a user ID for yourself. This must be a valid e-mail address. If you are a committer with an e-mail address in the FreeBSD.org domain, that is preferred; otherwise, your private e-mail address is OK. For mirror sites we recommend that you create an alias, for example "cvsup@cvsup17.jp.FreeBSD.org". In any case, the e-mail address should be real, such that mail sent to it will reach you. Like e-mail addresses, CVSup user IDs are case-insensitive.

Next, run cvpasswd like this:

    cvpasswd cvsup@cvsup17.jp.FreeBSD.org freefall.FreeBSD.org
replacing the first argument with your chosen user ID, of course. Note that the second argument must be "freefall.FreeBSD.org" even though the actual server is named "cvsup-master.FreeBSD.org".

The utility will prompt you for a password and give you instructions on what to do. Install the client portion of your key into "~xxx/.cvsup/auth", where "~xxx" is the home directory of the user who will be running the cvsup command. In modern versions of the cvsup-mirror port, that user is "cvsupin". In older versions, the user was root.

Mail the server portion of the key to <cvsup-master@FreeBSD.org>. We will notify you when your key has been installed on the master server.
Mirrored by CVSup


John Polstra, 14 June 2003