X-Git-Url: https://git.proxmox.com/?p=pve-common.git;a=blobdiff_plain;f=README.dev;h=df817e08ed15744e75149d1f4d62d58ec6f562b2;hp=bbd84f38f5a3551af3bbd3157d5f8ff13dd23e74;hb=69e15ccb477c892a0dfb3eddc46061f5e4cb6c65;hpb=bb9d386588339f40fb89ce198b98f93433aad251 diff --git a/README.dev b/README.dev index bbd84f3..df817e0 100644 --- a/README.dev +++ b/README.dev @@ -1,7 +1,8 @@ = Setup PVE Development Environment = 0. Read https://pve.proxmox.com/wiki/Developer_Documentation -1. Install Debian 9 'stretch' +1. Install Debian 9 'stretch' (you can also start from a PVE installation and + skip step 2 - 5, 7 - 11) 2. Configure the network interface(s) 3. Change the IP address of your hostname for proper name resolution in /etc/hosts @@ -34,10 +35,27 @@ = Install build prerequisites for development environment = -12. run: +NOTE: this is a huge and probably outdated list intended to be able to build +(almost) all packages, from the UI/API components to backend components to our +Linux Kernel. If you only want to hack on specific topics you won't need most +of those. +Instead we try to have a complete list of build dependencies in each source +repositories 'debian/control' file. If you run `make deb` dpkg-buildpackage +will stop and tell you if you miss some required packages. -apt-get install build-essential git git-email debhelper \ -autotools-dev autogen dh-autoreconf dkms doxygen check pkg-config \ +12. For installing the most important, always needed, ones run: + +apt-get install build-essential git git-email debhelper pve-doc-generator + +Additionally, for quickly installing (almost) all build dependencies run: + +WARNING: this list is almost for sure outdated! Use the build-deps definitions +defined in each package! You could install `devscripts` (huge package, but nice +helpers) and use: +# mk-build-deps --install +in the top-level directory of a git repository. + +apt-get install autotools-dev autogen dh-autoreconf dkms doxygen check pkg-config \ groff quilt dpatch automake autoconf libtool lintian libdevel-cycle-perl \ libjson-perl libcommon-sense-perl liblinux-inotify2-perl libio-stringy-perl \ libstring-shellquote-perl dh-systemd rpm2cpio libsqlite3-dev sqlite3 \ @@ -57,12 +75,12 @@ python-pyparsing libfilesys-df-perl libcrypt-ssleay-perl \ libfile-readbackwards-perl libanyevent-perl libanyevent-http-perl \ unzip liblocale-po-perl libfile-sync-perl cstream \ lzop dtach apt-transport-https hdparm gdisk parted ttf-dejavu-core \ -liblzma-dev dosfstools mtools libxen-dev libfuse-dev corosync-dev \ -libcpg-dev libquorum-dev libcmap-dev libuuid-perl \ -libqb-dev libapparmor-dev docbook2x libcap-dev dh-apparmor \ -graphviz libseccomp-dev libglib-perl libgtk3-perl libnss3-dev libdlm-dev \ -libudev-dev asciidoc-dblatex source-highlight libiscsi-dev libiscsi7 \ -librsvg2-bin +liblzma-dev dosfstools mtools libxen-dev libfuse-dev libcpg-dev libquorum-dev \ +libcmap-dev libuuid-perl libqb-dev libapparmor-dev docbook2x libcap-dev \ +dh-apparmor graphviz libseccomp-dev libglib-perl libgtk3-perl libnss3-dev \ +libdlm-dev libudev-dev asciidoc-dblatex source-highlight libiscsi-dev \ +libiscsi7 librsvg2-bin libarchive-dev libgpgme-dev libcurl4-gnutls-dev \ +libtest-mockmodule-perl libjemalloc-dev libjpeg-dev = Compile PVE packages from Source =