Updating the source tree - Revision history

Sidetone at 12:52, 30 October 2015

2015-10-30T12:52:06Z

Sidetone: svnup

2014-12-21T14:31:47Z

svnup

Sidetone: moving sections to cvs. since cvs no longer does this function.

2014-12-20T18:17:44Z

moving sections to cvs. since cvs no longer does this function.

Sidetone at 20:06, 18 December 2014

2014-12-18T20:06:42Z

Sidetone at 20:00, 18 December 2014

2014-12-18T20:00:54Z

Sidetone: /* ctm */

2014-12-18T18:43:59Z

ctm

Sidetone: /* References */ reference about csup is in csup article. It was used for general information about the program, and where this information was introduced.

2014-12-17T19:45:53Z

References: reference about csup is in csup article. It was used for general information about the program, and where this information was introduced.

Sidetone: csup, which is in the base system, is a direct replacement for cvsup for most purposes

2014-12-17T19:44:02Z

csup, which is in the base system, is a direct replacement for cvsup for most purposes

Joe: the source counterpart to the Updating the ports tree file

2005-12-23T11:39:53Z

the source counterpart to the Updating the ports tree file

New page

When updating your FreeBSD system, you'll first want to sync your sources to the live sources offered via [[cvs]]. There is a port [[cvsup]] that you can use to update your other ports and source trees if you want. If you hail from a Windows environment, you may think of keeping your sources updated as about the first half of the FreeBSD procedure which corresponds to [[Windows Update]]. There are two major systems that most users will want to keep up to date, the source tree (described here), and the ports tree (described in [[Updating the ports tree]]).

The source tree is the actual code for the kernel and the fundamental system programs (collectively known as the 'world') for the FreeBSD operating system.

== Installing cvsup ==
If, as root, '''which cvsup''' does not return the location of your cvsup install, you will need to install [[cvsup]] or [[cvsup-without-gui]] as described in [[Ports,_Installing]]. The cvsup program is the same as cvsup-without-gui if you do not have the X system installed, but many people prefer the non-gui version, as the ''cvsup'' version defaults to working in an X11 window (overridden with the -g flag).

== Selecting your source tree ==
If you intend to update to a newer version of FreeBSD, you need to select a cvs tag as described in [[FreeBSD Release Branches]].

== So it's installed already, how do I update the source tree? ==

===Configuring your supfile===
Assuming you have a copy of cvsup installed, you should have a file named '''standard-supfile''' or something similer in '''/usr/share/examples/cvsup'''. Copy it somewhere else, such as into /root, and open the copy with a text editor. The following is the file that I use:
*default host=cvsup4.jp.FreeBSD.org ''pick a nearby server from [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/cvsup.html#CVSUP-MIRRORS]''
*default base=/var/db
*default prefix=/usr ''source will be placed in /usr/src''
*default release=cvs tag=RELENG_6 ''Replace RELENG_6 with your cvsup tag''
*default delete use-rel-suffix
*default compress
src-all

This is basically a default supfile, with the host and release cvstag changed.

Save and close this file

===Updating your source using the file===
Assuming you have the supfile in your root directory named standard-supfile, run as root:
''cd /root''
''cvsup standard-supfile''
or
''cd /root''
''cvsup -g standard-supfile''
The first time you run this command, it will probably take a significant amount of time. It will go out to the server you picked in the supfile, and attempt to update all of the source code needed to update FreeBSD to whatever version you have picked. Handbook references for gobs of details: [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/synching.html Other methods of getting source], [http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/cvsup.html Details and optional flags to cvsup].

In a perfect world, that will always work. The only times when it wont are when you don't have connectivity or the server that you're cvsup-ing against is not allowing connections. The ''-g'' switch just makes sure that the GUI stuff in the regular CVSup program doesn't run, which many users prefer.

== It's updated. Now what? ==
Well... since you ended up here in the first place... I'm guessing you either came from [[Upgrading_the_base_system]], [[Custom Kernel]] or [[Updating the system]]. Usually you update the source to do one of the first two.

[[Category:Common Tasks]]

@@ Line 6: / Line 6: @@
 == Subversion ==
-An easy way to update through [[subversion]] is to install svnup; edit its configuration file; then run the command with the option set in ''/usr/local/etc/svnup.conf'' .
+An easy way to update through [[subversion]] is to install svnup; edit its configuration file; then run the command with the option set in {{file|/usr/local/etc/svnup.conf}}.
-Incomplete ''svnup.conf'' file:
+Partial {{file|svnup.conf}} file:
-  host=[choose server]
+  host=''[choose server]''  # uncomment one of these lines
+  #
   [release]
@@ Line 15: / Line 15: @@
   target=/usr/src
-The command with arguments in this example is:
+The command to run with arguments in this example is:
-  #svnup release
+  % svnup release
 == ctm ==

← Older revision		Revision as of 14:31, 21 December 2014
Line 4:		Line 4:

	CVS for updating FreeBSD sources, ports and base is depreciated. This function has been replaced by subversion and CTM. [http://www.freebsd.org/developers/cvs.html FreeBSD: Source code repositories]		CVS for updating FreeBSD sources, ports and base is depreciated. This function has been replaced by subversion and CTM. [http://www.freebsd.org/developers/cvs.html FreeBSD: Source code repositories]
		+
		+	== Subversion ==
		+	An easy way to update through [[subversion]] is to install svnup; edit its configuration file; then run the command with the option set in ''/usr/local/etc/svnup.conf'' .
		+
		+	Incomplete ''svnup.conf'' file:
		+	host=[choose server]
		+	#
		+	[release]
		+	branch=base/releng/10.1
		+	target=/usr/src
		+
		+	The command with arguments in this example is:
		+	#svnup release

	== ctm ==		== ctm ==

@@ Line 1: / Line 1: @@
-When updating your FreeBSD system, you'll first want to sync your sources to the live sources offered via [[cvs]]. [[csup]], available in recent base systems, can update your other ports and source trees.   If you hail from a Windows environment, you may think of keeping your sources updated as about the first half of the FreeBSD procedure which corresponds to [[Windows Update]]. There are two major systems that most users will want to keep up to date, the source tree (described here), and the ports tree (described in [[Updating the ports tree]]).
+When updating your FreeBSD system, you'll first want to sync your sources to the live sources. This was previously offered via [[cvs]]. If you hail from a Windows environment, you may think of keeping your sources updated as about the first half of the FreeBSD procedure which corresponds to [[Windows Update]]. There are two major systems that most users will want to keep up to date, the source tree (described here), and the ports tree (described in [[Updating the ports tree]]).
 The source tree is the actual code for the kernel and the fundamental system programs (collectively known as the 'world') for the FreeBSD operating system.
 CVS for updating FreeBSD sources, ports and base is depreciated. This function has been replaced by subversion and CTM. [http://www.freebsd.org/developers/cvs.html FreeBSD: Source code repositories]
 == ctm ==

@@ Line 3: / Line 3: @@
 The source tree is the actual code for the kernel and the fundamental system programs (collectively known as the 'world') for the FreeBSD operating system.
-CVS for updating FreeBSD sources, ports and base is depreciated. [http://www.freebsd.org/developers/cvs.html]
+CVS for updating FreeBSD sources, ports and base is depreciated. This function has been replaced by subversion and CTM. [http://www.freebsd.org/developers/cvs.html FreeBSD: Source code repositories]
 == cvs ==

← Older revision		Revision as of 20:00, 18 December 2014
Line 2:		Line 2:

	The source tree is the actual code for the kernel and the fundamental system programs (collectively known as the 'world') for the FreeBSD operating system.		The source tree is the actual code for the kernel and the fundamental system programs (collectively known as the 'world') for the FreeBSD operating system.
		+
		+	CVS for updating FreeBSD sources, ports and base is depreciated. [http://www.freebsd.org/developers/cvs.html]

	== cvs ==		== cvs ==

@@ Line 39: / Line 39: @@
 == ctm ==
-Ctm is another way to update source files. It appears that this method has security issues. Please see the FreeBSD Handbook (Appendix A), and ctm's man page for details.
+[[Ctm]] is another way to update source files. It appears that this method has security issues. Please see the FreeBSD Handbook (Appendix A), and ctm's man page for more details.
 == It's updated. Now what? ==

← Older revision		Revision as of 19:45, 17 December 2014
Line 45:		Line 45:


−	~~==References==~~
−	* Network Administration with FreeBSD 7 (2008) - for general information about csup

	[[Category:Common Tasks]]		[[Category:Common Tasks]]

@@ Line 1: / Line 1: @@
-When updating your FreeBSD system, you'll first want to sync your sources to the live sources offered via [[cvs]]. There is a port [[cvsup]] that you can use to update your other ports and source trees if you want.   If you hail from a Windows environment, you may think of keeping your sources updated as about the first half of the FreeBSD procedure which corresponds to [[Windows Update]]. There are two major systems that most users will want to keep up to date, the source tree (described here), and the ports tree (described in [[Updating the ports tree]]).
+When updating your FreeBSD system, you'll first want to sync your sources to the live sources offered via [[cvs]]. [[csup]], available in recent base systems, can update your other ports and source trees.   If you hail from a Windows environment, you may think of keeping your sources updated as about the first half of the FreeBSD procedure which corresponds to [[Windows Update]]. There are two major systems that most users will want to keep up to date, the source tree (described here), and the ports tree (described in [[Updating the ports tree]]).
 The source tree is the actual code for the kernel and the fundamental system programs (collectively known as the 'world') for the FreeBSD operating system.
-== Installing cvsup ==
+== cvs ==
-If, as root, '''which cvsup''' does not return the location of your cvsup install, you will need to install [[cvsup]] or [[cvsup-without-gui]] as described in [[Ports,_Installing]]. The cvsup program is the same as cvsup-without-gui if you do not have the X system installed, but many people prefer the non-gui version, as the ''cvsup'' version defaults to working in an X11 window (overridden with the -g flag).
+Considering that csup comes with the base system in recent releases, installing cvsup is unnecessary for updating the source tree (or ports). Csup uses the same supfile configuration as cvsup, and many of the commands for cvsup also apply to csup.
 == Selecting your source tree ==
@@ Line 35: / Line 37: @@
 In a perfect world, that will always work. The only times when it wont are when you don't have connectivity or the server that you're cvsup-ing against is not allowing connections. The ''-g'' switch just makes sure that the GUI stuff in the regular CVSup program doesn't run, which many users prefer.
 == It's updated. Now what? ==
 Well... since you ended up here in the first place... I'm guessing you either came from [[Upgrading_the_base_system]], [[Custom Kernel]] or [[Updating the system]]. Usually you update the source to do one of the first two.
 [[Category:Common Tasks]]