summaryrefslogtreecommitdiff
path: root/pages/docs
diff options
context:
space:
mode:
authorXavi Artigas <xavierartigas@yahoo.es>2018-06-12 04:05:58 -0700
committerapache <apache@e5-web1.enlightenment.org>2018-06-12 04:05:58 -0700
commit4b7a061d06ecd1beb4a61786eca56c51b6c8a7da (patch)
tree9023ca5e44affd75c0914b746223ecf9489a023c /pages/docs
parent8159c04ae77d07330401a1e4d2f30dcf9fc447cf (diff)
Wiki page openbsd-start.md changed with summary [created on behalf of netstar] by Xavi Artigas
Diffstat (limited to 'pages/docs')
-rw-r--r--pages/docs/distros/openbsd-start.md.txt191
1 files changed, 191 insertions, 0 deletions
diff --git a/pages/docs/distros/openbsd-start.md.txt b/pages/docs/distros/openbsd-start.md.txt
new file mode 100644
index 000000000..51aec4878
--- /dev/null
+++ b/pages/docs/distros/openbsd-start.md.txt
@@ -0,0 +1,191 @@
1---
2~~Title: Installing EFL on OpenBSD~~
3~~NOCACHE~~
4---
5
6# Installing EFL on OpenBSD #
7
8[The *Enlightenment Foundation Libraries (EFL)*](/about-efl.md) power millions of systems from mobile phones to set-top boxes, desktops, laptops, game systems and more. You'll need EFL if you want to develop apps for Enlightenment and for any of the devices that use Enlightenment for its visual interface.
9
10This tutorial describes several ways to install EFL on your system. You will only need to use one of these. Select your chosen method using the index on the right.
11
12The Enlightenment developers provide a pre-packaged source of EFL. Although not bleeding edge it is up to date and considered stable for production environments. You can download, compile and install it yourself by following the instructions in ["Installing from Packaged Source"](#Installing_from_Packaged_Source).
13
14You can also download the source code for the most recent version from the EFL git repositories. This will provide you with the latest code, which is updated on a nightly basis. To get started, read the section ["Installing from Git"](#Installing_from_Git).
15
16Finally, there's an installer available for OpenBSD + Enlightenment in the last section ["Enlightenment for OpenBSD Installer"](#Enlightenment_for_OpenBSD_Installer).
17
18Whichever installation method you use, visit ["Compiling EFL Applications"](#Compiling_EFL_Applications) to discover how to compile your Enlightenment applications.
19
20## Installing from Packaged Source ##
21
22There are two versions of EFL available from the Enlightenment website. One is the nightly bleeding edge version which you can [download using git](#Installing_from_Git). The other is packaged and available from the [EFL download page](https://download.enlightenment.org/rel/libs/efl/), which is the focus of this section.
23
24### Step 1: Downloading Stable Version ###
25
26[Download the latest version of EFL](https://download.enlightenment.org/rel/libs/efl/) and check it against its SHA256 hash:
27
28```bash
29wget --no-check-certificate https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz
30wget --no-check-certificate https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz.sha256
31cat efl-X.XX.X.tar.xz.sha256; sha256sum efl-X.XX.X.tar.xz
32```
33
34Note that you'll need to change ``X.XX.X`` to the actual version of EFL e.g. efl-1.20.6.tar.xz
35
36### Step 2: Unpacking ###
37
38Once you've downloaded the archive file containing EFL to your hard drive unpack it with:
39
40```bash
41tar xvf efl-X.XX.X.tar.xz
42```
43
44This will produce a folder named *efl-X.XX.X*.
45
46### Step 3: Installing Dependencies ###
47
48```bash
49su
50pkg_add autoconf automake bullet check fribidi gettext-tools giflib gmake gstreamer1 gstreamer1-plugins-base gstreamer1-plugins-good gstreamer1-plugins-bad gstreamer1-plugins-ugly gstreamer1-plugins-libav poppler libraw librsvg libspectre libtool libXp luajit m4 png pulseaudio tiff xprintproto
51```
52
53### Step 4: Building and Installing ###
54
55Set up these environment variables before building.
56
57```bash
58su
59ulimit -n unlimited;
60export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/X11R6/lib/pkgconfig"
61export AUTOCONF_VERSION=2.69
62export AUTOMAKE_VERSION=1.15
63export LDFLAGS="-lc++abi -lpthread -L/usr/lib -L/usr/X11R6/lib -L/usr/local/lib -L/usr/local/lib/pulseaudio"
64export CC=clang
65export CXX=clang++
66export CFLAGS="-femulated-tls"
67```
68
69Once you have installed all the required packages and setup the build environment ``cd`` into the *efl-X.XX.X* folder and run:
70
71```bash
72./configure
73gmake
74su
75gmake install
76```
77
78This will configure the files needed for compiling, compile the software itself and then install it.
79
80### Step 5: Carrying out Post Installation Tasks ###
81
82As you are not installing to */usr* but to */usr/local* you need to ensure that some files are visible to *dbus*:
83
84```bash
85su
86ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
87```
88Due to differing library `soname` versioning you also need to create necessary symbolic links ensuring full compatibility and working EFL on OpenBSD. These are subsequent to change, the important factor is that a valid symbolic link points to the destination as shown below:
89
90```bash
91su
92ln -s /usr/local/lib/libcurl.so.25.14 /usr/local/libcurl.so.4
93ln -s /usr/local/lib/libpulse.so.6.3 /usr/local/lib/libpulse.so.0
94ln -s /usr/local/lib/libsndfile.so.5.0 /usr/local/lib/libsndfile.so.1
95```
96
97## Installing from Git ##
98
99You can also install the bleeding edge version of EFL by cloning it from the git repository.
100
101### Step 1: Installing git and Cloning ###
102
103By default, *git* is not installed on OpenBSD, so the first step is to install it:
104
105```bash
106pkg_add git
107```
108
109Next clone EFL's source code:
110
111```bash
112git clone https://git.enlightenment.org/core/efl.git
113```
114
115This will create a directory named *efl/*.
116
117### Step 2: Installing Dependencies ###
118
119As with packaged install, you'll need the following dependencies:
120
121```bash
122su
123pkg_add autoconf automake bullet check fribidi gettext-tools giflib gmake gstreamer1 gstreamer1-plugins-base gstreamer1-plugins-good gstreamer1-plugins-bad gstreamer1-plugins-ugly gstreamer1-plugins-libav poppler libraw librsvg libspectre libtool libXp luajit m4 png pulseaudio tiff xprintproto
124```
125
126### Step 3: Configuring the Software ###
127
128Set up these environment variables before building.
129
130```bash
131su
132ulimit -n unlimited;
133export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/X11R6/lib/pkgconfig"
134export AUTOCONF_VERSION=2.69
135export AUTOMAKE_VERSION=1.15
136export LDFLAGS="-lc++abi -lpthread -L/usr/lib -L/usr/X11R6/lib -L/usr/local/lib -L/usr/local/lib/pulseaudio"
137export CC=clang
138export CXX=clang++
139export CFLAGS="-femulated-tls"
140```
141
142Once you have installed all the required packages and setup the build environment ``cd`` into the *efl-X.XX.X* folder and run:
143
144```bash
145./autogen.sh
146```
147
148Once configured, compile the software with:
149
150```bash
151gmake
152su
153gmake install
154```
155
156### Step 4: Carrying out Post Installation Tasks ###
157
158As you are not installing to */usr* but to */usr/local*, you need to ensure that some files are visible to *dbus*:
159
160```bash
161su
162ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
163```
164
165Due to differing library `soname` versioning you also need to create necessary symbolic links ensuring full compatibility and working EFL on OpenBSD. These are subsequent to change, the important factor is that a valid symbolic link points to the destination as shown below:
166
167```bash
168ln -s /usr/local/lib/libcurl.so.25.14 /usr/local/libcurl.so.4
169ln -s /usr/local/lib/libpulse.so.6.3 /usr/local/lib/libpulse.so.0
170ln -s /usr/local/lib/libsndfile.so.5.0 /usr/local/lib/libsndfile.so.1
171```
172
173## Enlightenment for OpenBSD Installer ##
174
175There is also a stable release of OpenBSD, EFL and Enlightenment called *Enlightened*, distributed at:
176
177[http://bogosys.org/openbsd.html](http://bogosys.org/openbsd.html)
178
179You can download an `amd64` image for BIOS/EFI systems including lots of OpenBSD and Enlightenment software. The plan is to create one Enlightened release per OpenBSD release.
180
181The current version is an OpenBSD 6.3 installer and includes EFL 1.20.7 and Enlightenment 0.22.3.
182
183This is maintained by [Bogosys](http://bogosys.org), a software company doing Enlightenment work and is not an official Enlightenment project.
184
185## Troubleshooting ##
186
187If you are having problems compiling and installing EFL you can find help on any of [our IRC channels](https://www.enlightenment.org/contact) or [post a ticket to our Phabricator](https://phab.enlightenment.org).
188
189## Installing on Other Operating Systems ##
190
191If you would like to install EFL on a different operating system visit the [Installing EFL](start) page. \ No newline at end of file