From e1526ffa31150849a329a3974cceb151193a1364 Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Wed, 26 Apr 2006 15:35:10 -0300 Subject: Some improvements at Makefile From: Mauro Carvalho Chehab Included a INSTALL file make help shows the INSTALL file added make release to force compiling against a specified version Signed-off-by: Mauro Carvalho Chehab --- INSTALL | 99 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 INSTALL (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL new file mode 100644 index 000000000..28ea51ef7 --- /dev/null +++ b/INSTALL @@ -0,0 +1,99 @@ +Mauro Carvalho Chehab 2006 Apr 26 + +V4L/DVB building procedures are based at the use of Makefile rules. +Those rules are close tho the ones at Linux Kernel, to allow an easier +usage. + +======================================================================= +Quick building procedure is: + make all +====================================================================== + +For those that may want more than just build all stuff there are some +other interesting parameters to make: + +====================== +Normal building rules: +all - build all modules + +clean - Cleans compiled files from the tree, + but keeping the latest + used configuration and kernel version + +distclean - Cleans compiled files from the tree, + latest used configuration and kernel + version. + +default - Continues building the latest module selection + This is the behavior when just typed: + make + +install - Installs all modules at kernel's default dir + for V4L/DVB. Requires root access. + +======================= +Module selection rules: +(Those may require write access to kernel tree) + +allmodconfig - Called by make all. Selects all modules that are known + to compile against the kernel version used. + +xconfig - Generate a xconfig menu. Requires full + kernel source, since it depends on kernel's + qconf stript; + +gconfig - Generate a qt menu. Requires full + kernel source, since it depends on kernel's + gconf stript; + +config - Generate a text-mode menu. Requires full + kernel source, since it depends on kernel's + conf stript; + +menuconfig - Generate a ncurses menu. Requires full + kernel source, since it depends on kernel's + mconf and lxconfig stripts; + +release - Allows changing kernel version. + Typical usage is: + make release VER=2.6.12-18mdk + (to force compiling to 2.6.12-18mdk) + This will work only if + /lib/modules/2.6.12-18mdk/build/ + points to that kernel version + To use current kernel version instead: + make release + +====================== +Module handling rules: +(require root access) + +insmod - inserts all modules from V4L/DVB tree + +rmmod - removes all modules from V4L/DVB tree + +reload - removes then reinserts all modules + +=================== +Tree merging rules: + +ivtv-checkout - retrieve latest ivtv sources from the site + +ivtv-update - updates from ivtv sources + +ivtv - Prepare ivtv to compile with the tree + +========================================== +Patch preparation and tree handling rules: +(used by developers) + +kernel-links - Generate links to V4L/DVB at kernel tree. + Requires write access to kernel tree. + +cardlist - Updates Documentation/video4linux/CARDLIST.* + +update - updates the tree from master repository + +commit - commits the change, asking for a commit msg + +push - sends outgoing stuff to master repository -- cgit v1.2.3 From e6f2467bcc7b9ca1e7de8cd2ea21b2af83892c9d Mon Sep 17 00:00:00 2001 From: Michael Krufky Date: Thu, 27 Apr 2006 01:29:21 -0400 Subject: fix ivtv tree merge help info in INSTALL file From: Michael Krufky ivtv - enable merged ivtv build, using the latest ivtv sources from ivtvdriver.org (requires subversion) cx88-ivtv - enable cx88-blackbird ivtv API emulation ivtv-update - update ivtv sources ivtv-install - install ivtv and/or cx88-ivtv modules (requires root access) Signed-off-by: Michael Krufky --- INSTALL | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 28ea51ef7..d75b05dbe 100644 --- a/INSTALL +++ b/INSTALL @@ -77,11 +77,14 @@ reload - removes then reinserts all modules =================== Tree merging rules: -ivtv-checkout - retrieve latest ivtv sources from the site +ivtv - enable merged ivtv build, using the latest ivtv sources + from ivtvdriver.org (requires subversion) -ivtv-update - updates from ivtv sources +cx88-ivtv - enable cx88-blackbird ivtv API emulation -ivtv - Prepare ivtv to compile with the tree +ivtv-update - update ivtv sources + +ivtv-install - install ivtv and/or cx88-ivtv modules (requires root access) ========================================== Patch preparation and tree handling rules: -- cgit v1.2.3 From 366fa98a817c19558aaa09755a2ce12931a35f3d Mon Sep 17 00:00:00 2001 From: Michael Krufky Date: Thu, 27 Apr 2006 09:30:20 -0400 Subject: move install / rminstall invocation rules to v4l/Makefile From: Michael Krufky This patch moves the 'make install' and 'make rminstall' rules into the central Makefile. This allows for us to assign dependencies to these rules, so that modules built as a reult of a tree-merge don't have to be installed separately. Now, instead of doing 'make install && make ivtv-install', the simple command, 'make install' will call the sub-install rules and take care of the entire task. Signed-off-by: Michael Krufky --- INSTALL | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index d75b05dbe..acf41dbb1 100644 --- a/INSTALL +++ b/INSTALL @@ -82,9 +82,7 @@ ivtv - enable merged ivtv build, using the latest ivtv sources cx88-ivtv - enable cx88-blackbird ivtv API emulation -ivtv-update - update ivtv sources - -ivtv-install - install ivtv and/or cx88-ivtv modules (requires root access) +ivtv-update - update ivtv sources from ivtvdriver.org ========================================== Patch preparation and tree handling rules: -- cgit v1.2.3 From c460d095132c434e7c9b7e6c07ac34fef2c71557 Mon Sep 17 00:00:00 2001 From: Mauro Carvalho Chehab Date: Fri, 28 Apr 2006 09:34:06 -0300 Subject: Improved make release method to allow compiling against an arbitrary dir From: Mauro Carvalho Chehab Now, with make DIR=, it is possible to compile V4L/DVB with a non-installed dir. This will allow better checking on compatibility issues (especially for -git tree) Signed-off-by: Mauro Carvalho Chehab --- INSTALL | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index acf41dbb1..d71688cdf 100644 --- a/INSTALL +++ b/INSTALL @@ -58,9 +58,12 @@ release - Allows changing kernel version. Typical usage is: make release VER=2.6.12-18mdk (to force compiling to 2.6.12-18mdk) - This will work only if - /lib/modules/2.6.12-18mdk/build/ - points to that kernel version + (This will work only if + /lib/modules/2.6.12-18mdk/build/ + points to that kernel version) + Or + make release DIR=~/linux-git + (to force using kernel at a specific dir) To use current kernel version instead: make release -- cgit v1.2.3