wiki.ipfire.org

The community-maintained documentation platform of IPFire

User Tools

Site Tools


development:addon:details:lfs-fragment

A generic template for this file is as follows:

template
##############################################################################
#                                                                             #
# IPFire.org - A linux based firewall                                         #
# Copyright (C) 2007  Michael Tremer & Christian Schmidt                      #
#                                                                             #
# This program is free software: you can redistribute it and/or modify        #
# it under the terms of the GNU General Public License as published by        #
# the Free Software Foundation, either version 3 of the License, or           #
# (at your option) any later version.                                         #
#                                                                             #
# This program is distributed in the hope that it will be useful,             #
# but WITHOUT ANY WARRANTY; without even the implied warranty of              #
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               #
# GNU General Public License for more details.                                #
#                                                                             #
# You should have received a copy of the GNU General Public License           #
# along with this program.  If not, see <http://www.gnu.org/licenses/>.       #
#                                                                             #
###############################################################################
 
###############################################################################
# Definitions
###############################################################################
 
include Config
 
VER        = 1.0.0
 
THISAPP    = progname-$(VER)
DL_FILE    = $(THISAPP).tar.gz
DL_FROM    = $(URL_IPFIRE)
DIR_APP    = $(DIR_SRC)/$(THISAPP)
TARGET     = $(DIR_INFO)/$(THISAPP)
PROG       = progname
PAK_VER    = 2
 
DEPS       = ""
 
###############################################################################
# Top-level Rules
###############################################################################
 
objects = $(DL_FILE)
 
$(DL_FILE) = $(DL_FROM)/$(DL_FILE)
 
$(DL_FILE)_MD5 = 83fb77e937e9401ede73875c631f118e
 
install : $(TARGET)
check : $(patsubst %,$(DIR_CHK)/%,$(objects))
 
download :$(patsubst %,$(DIR_DL)/%,$(objects))
 
md5 : $(subst %,%_MD5,$(objects))
 
dist:.
	$(PAK)
 
###############################################################################
# Downloading, checking, md5sum
###############################################################################
 
$(patsubst %,$(DIR_CHK)/%,$(objects)) :
	@$(CHECK)
 
$(patsubst %,$(DIR_DL)/%,$(objects)) :
	@$(LOAD)
 
$(subst %,%_MD5,$(objects)) :
	@$(MD5)
 
###############################################################################
# Installation Details
###############################################################################
 
$(TARGET) : $(patsubst %,$(DIR_DL)/%,$(objects))
	@$(PREBUILD)
	@rm -rf $(DIR_APP) && cd $(DIR_SRC) && tar zxf $(DIR_DL)/$(DL_FILE)
	cd $(DIR_APP) && make $(MAKETUNING) $(EXTRA_MAKE)
	cd $(DIR_APP) && make install
	@rm -rf $(DIR_APP)
	@$(POSTBUILD)

Here are the detailed explanation of modifications for foo2zjs:

  • VERSION apparently this package does not have a version number, so I elected to have noversion
  • THISAPP this I had to modify to remove versioning.
  • DL_FILE the name of the archive containing the application
  • DL_FROM the url where the archive can be downloaded from (notice this is a very unusual case where the archive is in the root directory of the server).
  • PROG usually it is the same as THISAPP minus the version number; in my case they coincide.
  • $(DL_FILE)_MD5 this is the md5 checksum of the downloaded file; You should already have the file on your disk so just call:
mcon@vmrunner:~/sandbox/ipfire-2.x/cache$ md5sum foo2zjs.tar.gz 
83fb77e937e9401ede73875c631f118e  foo2zjs.tar.gz
  • $(DL_FILE)_MD5 You will need to adjust several lines:
    • adjust the archive unpacking line (you may have a different compression z/gz/bz2/… and/or archiver tar/zip/7z/arc/…)
    • add (if needed) the configuration line
    • adjust (if needed) the compile line (e.g.: make all …)
    • add any needed compilation steps (in my case I had to add ./getweb all to download from the Internet all printer definitions. This has been a major headache because this Makefile runs in a chrooted environment and the active /etc/resolv.conf contains just nameserver 127.0.0.1. For this reason I had to install a DNS-proxy in my compilation machine).
    • add any needed post-installation hooks make cups in my case.

The complete file is as follows:

foo2zjs
###############################################################################
#                                                                             #
# IPFire.org - A linux based firewall                                         #
# Copyright (C) 2007  Michael Tremer & Christian Schmidt                      #
#                                                                             #
# This program is free software: you can redistribute it and/or modify        #
# it under the terms of the GNU General Public License as published by        #
# the Free Software Foundation, either version 3 of the License, or           #
# (at your option) any later version.                                         #
#                                                                             #
# This program is distributed in the hope that it will be useful,             #
# but WITHOUT ANY WARRANTY; without even the implied warranty of              #
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               #
# GNU General Public License for more details.                                #
#                                                                             #
# You should have received a copy of the GNU General Public License           #
# along with this program.  If not, see <http://www.gnu.org/licenses/>.       #
#                                                                             #
###############################################################################
 
###############################################################################
# Definitions
###############################################################################
 
include Config
 
VER        = noversion
 
#THISAPP    = foo2zjs-$(VER)
THISAPP    = foo2zjs
DL_FILE    = $(THISAPP).tar.gz
#DL_FROM    = $(URL_IPFIRE)
DL_FROM    = http://foo2zjs.rkkda.com
DIR_APP    = $(DIR_SRC)/$(THISAPP)
TARGET     = $(DIR_INFO)/$(THISAPP)
PROG       = foo2zjs
PAK_VER    = 2
 
DEPS       = "foomatic"
 
###############################################################################
# Top-level Rules
###############################################################################
 
objects = $(DL_FILE)
 
$(DL_FILE) = $(DL_FROM)/$(DL_FILE)
 
$(DL_FILE)_MD5 = 83fb77e937e9401ede73875c631f118e
 
install : $(TARGET)
 
check : $(patsubst %,$(DIR_CHK)/%,$(objects))
 
download :$(patsubst %,$(DIR_DL)/%,$(objects))
 
md5 : $(subst %,%_MD5,$(objects))
 
dist: 
	$(PAK)
 
###############################################################################
# Downloading, checking, md5sum
###############################################################################
 
$(patsubst %,$(DIR_CHK)/%,$(objects)) :
	@$(CHECK)
 
$(patsubst %,$(DIR_DL)/%,$(objects)) :
	@$(LOAD)
 
$(subst %,%_MD5,$(objects)) :
	@$(MD5)
 
###############################################################################
# Installation Details
###############################################################################
 
$(TARGET) : $(patsubst %,$(DIR_DL)/%,$(objects))
	@$(PREBUILD)
	@rm -rf $(DIR_APP) && cd $(DIR_SRC) && tar zxf $(DIR_DL)/$(DL_FILE)
	cd $(DIR_APP) && make $(MAKETUNING) $(EXTRA_MAKE)
	cd $(DIR_APP) && ./getweb all
	cd $(DIR_APP) && make install
	cd $(DIR_APP) && make cups
	@rm -rf $(DIR_APP)
	@$(POSTBUILD)
development/addon/details/lfs-fragment.txt · Last modified: 2010/11/17 16:28 by mc5686