summaryrefslogtreecommitdiff
path: root/distrib/notes/packages
blob: fe6a268dedda4a2941a89249ea94b067689c6e4c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
As complete as your OpenBSD system is you still may want to add any of
several excellent third party software applications.  There are several
ways to do this.  You can

1) Obtain the source code and building the application based
   upon whatever installation procedures are provided with the
   application.

2) Use the OpenBSD ``ports'' collection to automatically get any
   needed source file, apply any required patches, create the
   application, and install it for you.

3) Use the OpenBSD ``package'' collection to grab a pre-compiled
   and tested version of the application for your hardware.

If you purchased the OpenBSD CD-ROM you already have several popular
``packages'', the ``ports'' collection, and most of the ``ports''
source file releases.

Instructions for installing applications from various sources using
the various methods follow.  If emacs is to be installed it should
be installed first as it creates the ``info'' directory file that
may be modified by other applications.

Installing applications from the the CD-ROM package collection:

	The OpenBSD CD-ROM ships with applications pre-built
	for various hardware architectures.  The applications
	and supported architectures are:

			i386	sparc	amiga	m68k	alpha	mips
	emacs-20.2	yes	yes	no	yes	yes	no
	bash-2.01.1	yes	yes	no	yes	yes	no
	tcsh-6.07.02	yes	yes	no	yes	yes	no
	pine-3.96	yes	yes	no	yes	yes	no

	(the amiga is treated specially due to its 8k hardware pagesize
	aka NBPG, it's very well possible amiga will run the other m68k
	arch's binaries, but we make no guarantees at this point).

	To install one or more of these packages you must
	1) become the superuser (root)
	2) mount CD-ROM number 2
	3) use the ``pkg_add'' command to install the software

	Example:

    $ su
    Password: <enter your root password>
    # mkdir -p /cdrom
    # mount /dev/cd0a /cdrom
    # pkg_add /cdrom/packages/<arch>/<package-name>
    # <add more packages if desired>
    # umount /cdrom
	
	Your hardware architecture can be determined by issing
	the command ``arch''.  The response will be something like
	``OpenBSD.sparc''.  ``sparc'' is the architecture.

	Package names are usually the application name and version
	with .tgz appended, e.g. pine-3.96.tgz

Installing applications from the ftp.openbsd.org package collection:

	The above packages, and others, have been placed on
	ftp.openbsd.org in the directory pub/OpenBSD/2.3/packages/<arch>/
	where <arch> is the supported hardware architecture.  You may
	want to peruse the directory for your architecture to see what
	packages are available.

	Installation of a package is very easy.
	1) become the superuser (root)
	2) use the ``pkg_add'' command to install the software

	``pkg_add'' is smart enough to know how to download the software
	from the OpenBSD ftp server.  Example:

    $ su
    Password: <enter your root password>
    # pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/2.3/packages/i386/emacs-20.2.tgz

	Note: there are both USA and INTERNATIONAL versions of ssh and
	pgp on the ftp server.  Be sure to grab the correct version.
	The USA versions, ssh-usa-1.2.22.tgz and pgp-usa-2.6.3.tgz, use
	RSAREF, a legal requirement for use within the United States due
	to patent issues.

Installing applications from the CD-ROM ports collection:

	The CD-ROM ``ports'' collection is a set of Makefiles, patches,
	and other files used to control the building and installation
	of an application from source files.  The source files come
	from archives which are also, for the most part, on the
	OpenBSD CD-ROM.

	;;; <finish this>

Installing applications from the OpenBSD ports collection:

	;;; <finish this>

Installing other applications:

	If an OpenBSD package or port does not exist for an application
	you're pretty much on your own.  The first thing to do is ask
	ports@openbsd.org if anyone is working on a port -- there may
	be one in progress.  If no luck there you may try the FreeBSD
	ports or NetBSD package collection.  If you are on an i386 based
	machine it is quite possible that the FreeBSD port, if one exists,
	will work for you.

	If you can't find an existing port try to make your own and
	feed it back to OpenBSD.  That's how our ports collection grows.
	Some details can be found at http://www.openbsd.org/porting.html
	with more help coming from the mailing list, ports@openbsd.org.