aboutsummaryrefslogtreecommitdiff
path: root/portmidi/pm_linux/README_LINUX.txt
diff options
context:
space:
mode:
Diffstat (limited to 'portmidi/pm_linux/README_LINUX.txt')
-rwxr-xr-xportmidi/pm_linux/README_LINUX.txt99
1 files changed, 0 insertions, 99 deletions
diff --git a/portmidi/pm_linux/README_LINUX.txt b/portmidi/pm_linux/README_LINUX.txt
deleted file mode 100755
index cfbc43f..0000000
--- a/portmidi/pm_linux/README_LINUX.txt
+++ /dev/null
@@ -1,99 +0,0 @@
1README_LINUX.txt for PortMidi
2Roger Dannenberg
36 Dec 2012, revised May 2022
4
5Contents:
6 To make PortMidi
7 The pmdefaults program
8 Setting LD_LIBRARY_PATH
9 A note about amd64
10 Using autoconf
11 Using configure
12 Changelog
13
14
15See ../README.md for general instructions.
16
17THE pmdefaults PROGRAM
18
19(This may be obsolete. It is older than `../README.md` which
20also discusses pmdefaults, and Java support may be removed
21unless someone claims they use it... -RBD)
22
23You should install pmdefaults. It provides a graphical interface
24for selecting default MIDI IN and OUT devices so that you don't
25have to build device selection interfaces into all your programs
26and so users have a single place to set a preference.
27
28Follow the instructions above to run ccmake, making sure that
29CMAKE_BUILD_TYPE is Release. Run make as described above. Then:
30
31sudo make install
32
33This will install PortMidi libraries and the pmdefault program.
34You must alos have the environment variable LD_LIBRARY_PATH set
35to include /usr/local/lib (where libpmjni.so is installed).
36
37Now, you can run pmdefault.
38
39
40SETTING LD_LIBRARY_PATH
41
42pmdefaults will not work unless LD_LIBRARY_PATH includes a
43directory (normally /usr/local/lib) containing libpmjni.so,
44installed as described above.
45
46To set LD_LIBRARY_PATH, you might want to add this to your
47~/.profile (if you use the bash shell):
48
49LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib
50export LD_LIBRARY_PATH
51
52
53A NOTE ABOUT AMD64:
54
55When compiling portmidi under linux on an AMD64, I had to add the -fPIC
56flag to the gcc flags.
57
58Reason: when trying to build John Harrison's pyPortMidi gcc bailed out
59with this error:
60
61./linux/libportmidi.a(pmlinux.o): relocation R_X86_64_32 against `a local symbol' can not be used when making a shared object; recompile with -fPIC
62./linux/libportmidi.a: could not read symbols: Bad value
63collect2: ld returned 1 exit status
64error: command 'gcc' failed with exit status 1
65
66What they said:
67http://www.gentoo.org/proj/en/base/amd64/howtos/index.xml?part=1&chap=3
68On certain architectures (AMD64 amongst them), shared libraries *must*
69be "PIC-enabled".
70
71CHANGELOG
72
7327-may-2022 Roger B. Dannenberg
74 Some updates to this file.
75
766-dec-2012 Roger B. Dannenberg
77 Copied notes on Autoconf from Audacity sources
78
7922-jan-2010 Roger B. Dannenberg
80 Updated instructions about Java paths
81
8214-oct-2009 Roger B. Dannenberg
83 Using CMake now for building and configuration
84
8529-aug-2006 Roger B. Dannenberg
86 Fixed PortTime to join with time thread for clean exit.
87
8828-aug-2006 Roger B. Dannenberg
89 Updated this documentation.
90
9108-Jun-2004 Roger B. Dannenberg
92 Updated code to use new system abstraction.
93
9412-Apr-2003 Roger B. Dannenberg
95 Fixed pm_test/test.c to filter clocks and active messages.
96 Integrated changes from Clemens Ladisch:
97 cleaned up pmlinuxalsa.c
98 record timestamp on sysex input
99 deallocate some resources previously left open