--- qla-tools-0.20090725.orig/Makefile +++ qla-tools-0.20090725/Makefile @@ -0,0 +1,38 @@ +TARS=$(shell ls ql-set-cmd-timeout-*.tgz \ + ql-hba-snapshot-*.tgz \ + ql-lun-state-online-*.tgz \ + ql-dynamic-tgt-lun-disc-*.tgz) +DIRS=$(patsubst %.tgz,%,$(TARS)) + +SCRIPTS=$(shell find . -name '*.sh') + +all: $(DIRS) + +%: %.tgz + tar zxf $< + +install: $(SCRIPTS) + for SCRIPT in $(SCRIPTS); do \ + cp $$SCRIPT $(DESTDIR)/usr/sbin/`basename $$SCRIPT .sh`; \ + done + +clean: + rm -rf $(DIRS) + + +# This target is called by hand to create the basic manpages. Due the use of +# escape sequences in the scripts some handwork in the manpages is needed. +manpages: $(SCRIPTS) + for SCRIPT in $(SCRIPTS); do \ + help2man --version-option -h -N ./$$SCRIPT > /tmp/`basename $$SCRIPT .sh`.8 ; \ + done + +QL_DYN_TGT_VERSION=$(shell ls ql-dynamic-tgt-lun-disc-*.tgz| sed 's/ql-dynamic-tgt-lun-disc-\(.*\).tgz/\1/') + +repack: clean $(DIRS) + mv ql-dynamic-tgt-lun-disc-$(QL_DYN_TGT_VERSION) ql-dynamic-tgt-lun-disc-repacked-$(QL_DYN_TGT_VERSION) + rm ql-dynamic-tgt-lun-disc-repacked-$(QL_DYN_TGT_VERSION)/sg3_utils-*.tgz + tar --exclude=*.tgz -zcf ql-dynamic-tgt-lun-disc-repacked-$(QL_DYN_TGT_VERSION).tgz ql-dynamic-tgt-lun-disc-repacked-* + $(MAKE) clean + +.PHONY: clean --- qla-tools-0.20090725.orig/debian/ql-hba-snapshot.8 +++ qla-tools-0.20090725/debian/ql-hba-snapshot.8 @@ -0,0 +1,70 @@ +.TH "ql-hba-snapshot" "8" "July 2009" "Matthias Schmitz " "System Administration" +.SH "NAME" +ql\-hba\-snapshot \- display specific information of the QLogic HBA. +.SH "SYNOPSIS" +.B ql\-hba\-snapshot + [\fIOPTIONS\fR] +.SH "DESCRIPTION" +FC HBA Snapshot Utility + +This utility displays the details of the QLogic HBA attached to the +system. It uses one of the two file systems for scanning: proc or +sysfs. + + | <\-a/\-\-all> [optional] +.IP +Provide the to display the detailed +information of the HBA. +With no option specified, general information of all +hosts will be displayed. +Ex. +# /usr/sbin/ql\-hba\-snapshot +# /usr/sbin/ql\-hba\-snapshot \fB\-\-procfs\fR (For procfs) +.PP +\fB\-h\fR, \fB\-\-help\fR +.IP +Prints the help message. +Ex. +# /usr/sbin/ql\-hba\-snapshot \fB\-\-help\fR +.PP +\fB\-hl\fR, \fB\-\-hostlist\fR +.IP +This option displays the list of QLogic hosts (HBAs) +connected to this system. +The can be obtained by using following command +Ex. +# /usr/sbin/ql\-hba\-snapshot \fB\-\-hostlist\fR +.PP +\fB\-p\fR, \fB\-\-parameters\fR +.IP +This option displays the command line parameters that +can be passed to the QLogic HBA driver. +Ex. +# /usr/sbin/ql\-hba\-snapshot \fB\-\-parameters\fR +.PP +\fB\-s\fR, \fB\-\-statistics\fR +.IP +This option displays the statistical information for +specified host. Stastics option is only supported in +"sysfs" based scan. +Ex. +# /usr/sbin/ql\-hba\-snapshot \fB\-\-statistics\fR +.PP +\fB\-proc\fR, \fB\-\-procfs\fR +.IP +This options forces the the utility to scans information +based on "procfs", instead of default sysfs. +Ex. +# /usr/sbin/ql\-hba\-snapshot \fB\-\-procfs\fR [Other valid option] +.PP +\fB\-v\fR, \fB\-\-verbose\fR +.IP +This enables verbose display. The detailed information +of LUNs will be displayed in addition to standard one. +This option is only supported in sysfs. +Ex. +# /usr/sbin/ql\-hba\-snapshot \fB\-\-verbose\fR +.PP + +.SH "SEE ALSO" +ql\-dynamic\-tgt\-lun\-disc(8), ql\-lun\-state\-online(8), ql\-set\-cmd\-timeout(8) --- qla-tools-0.20090725.orig/debian/copyright +++ qla-tools-0.20090725/debian/copyright @@ -0,0 +1,40 @@ +This package was debianized by: + + Matthias Schmitz Tue, 28 Jul 2009 13:35:57 +0200 + +It was downloaded from: + + http://driverdownloads.qlogic.com/QLogicDriverDownloads_UI/SearchByProduct.aspx?ProductCategory=39&Product=936&Os=26 + +Upstream Author: + + QLogic Corp. + +Copyright: + + Copyright (C) 2008 QLogic Corp. + +License: + + This package is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License version 2 as + published by the Free Software Foundation. + + This package 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 package; if not, write to the Free Software + Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA + +On Debian systems, the complete text of the GNU General +Public License version 2 can be found in `/usr/share/common-licenses/GPL-2'. + +The Debian packaging is: + + Copyright (C) 2009 Matthias Schmitz + +and is licensed under the GPL version 3, +see `/usr/share/common-licenses/GPL-3'. --- qla-tools-0.20090725.orig/debian/dirs +++ qla-tools-0.20090725/debian/dirs @@ -0,0 +1 @@ +usr/sbin --- qla-tools-0.20090725.orig/debian/README.Source +++ qla-tools-0.20090725/debian/README.Source @@ -0,0 +1,14 @@ +qla-tools for Debian - source package notes +----------------------------------------------------- + +Go to http://www.qlogic.com, klick on Support. Choose Fibre Channel HBAs -> +Drivers, Software and Manuals. In the opening popup window select Fibre Channel +Adapters->QLA2460->Linux Red Hat (32-bit). Download all files under Linux +Tools, except 'HBA Collect Utility' + +The upstream tarball of ql-dynamic-tgt-lun-disc was repacked as followd: + + - remove sg3_utils-[version].tgz because it's still in Debian and licenced under BSD + - added -repacked in tarball file name + + -- Christoph Goehre Tue, 28 Jul 2009 15:08:59 +0200 --- qla-tools-0.20090725.orig/debian/docs +++ qla-tools-0.20090725/debian/docs @@ -0,0 +1 @@ +*/*.txt --- qla-tools-0.20090725.orig/debian/changelog +++ qla-tools-0.20090725/debian/changelog @@ -0,0 +1,27 @@ +qla-tools (0.20090725-1) unstable; urgency=low + + * New Upstream Version + * close ITP (Closes: #495305) + + [ Guido Günther ] + * [2aeacf0] Makefile: autodetect version of tgzs + + [ Matthias Schmitz ] + * [6c22ce6] update manpage ql-dynamic-tgt-lun-disc.8 + * [a07cb92] update manpage ql-hba-snapshot.8 + * [3dcff5d] make lintian happy + + [ Christoph Goehre ] + * [0b29991] change copyright holder of all man pages to Matthias + * [21655b4] README.Debian: rewrap to long text lines + * [c447548] document repack process of ql-dynamic-tgt-lun-disc upstream + * [1d6f2e2] clarification about upstream licence + * [6530a11] calm lintian again + + -- Christoph Goehre Wed, 29 Jul 2009 13:16:49 +0200 + +qla-tools (0.20080815-1) unstable; urgency=low + + * Initial release (Closes: #495305). + + -- Matthias Schmitz Fri, 15 Aug 2008 23:13:33 +0200 --- qla-tools-0.20090725.orig/debian/rules +++ qla-tools-0.20090725/debian/rules @@ -0,0 +1,85 @@ +#!/usr/bin/make -f +# -*- makefile -*- +# Sample debian/rules that uses debhelper. +# This file was originally written by Joey Hess and Craig Small. +# As a special exception, when this file is copied by dh-make into a +# dh-make output file, you may use that output file without restriction. +# This special exception was added by Craig Small in version 0.37 of dh-make. + +# Uncomment this to turn on verbose mode. +#export DH_VERBOSE=1 + + + + +CFLAGS = -Wall -g + +ifneq (,$(findstring noopt,$(DEB_BUILD_OPTIONS))) + CFLAGS += -O0 +else + CFLAGS += -O2 +endif + +configure: configure-stamp +configure-stamp: + dh_testdir + # Add here commands to configure the package. + + touch configure-stamp + + +build: build-stamp + +build-stamp: configure-stamp + dh_testdir + + # Add here commands to compile the package. + $(MAKE) + #docbook-to-man debian/qla-tools.sgml > qla-tools.1 + + touch build-stamp + +clean: + dh_testdir + dh_testroot + rm -f build-stamp configure-stamp + + # Add here commands to clean up after the build process. + $(MAKE) clean + + dh_clean + +install: build + dh_testdir + dh_testroot + dh_prep + dh_installdirs + + # Add here commands to install the package into debian/qla-tools. + $(MAKE) install DESTDIR=$(CURDIR)/debian/qla-tools + + +# Build architecture-independent files here. +binary-indep: build install +# We have nothing to do by default. + dh_testdir + dh_testroot + dh_installchangelogs + dh_installdocs + dh_installexamples + dh_installman debian/ql-hba-snapshot.8 debian/ql-set-cmd-timeout.8 debian/ql-dynamic-tgt-lun-disc.8 debian/ql-lun-state-online.8 + dh_link + dh_strip + dh_compress + dh_fixperms + dh_installdeb + dh_gencontrol + dh_md5sums + dh_builddeb + +# Build architecture-dependent files here. +binary-arch: build install + + +binary: binary-indep binary-arch +.PHONY: build clean binary-indep binary-arch binary install configure --- qla-tools-0.20090725.orig/debian/compat +++ qla-tools-0.20090725/debian/compat @@ -0,0 +1 @@ +7 --- qla-tools-0.20090725.orig/debian/README.Debian +++ qla-tools-0.20090725/debian/README.Debian @@ -0,0 +1,20 @@ +qla-tools for Debian +----------------------- +QLogic provides a bunch of linux tools for handling their HBAs on its website. +Unfortunaly they support only RedHat and Novell SLES so we need to package the +tools for ourself. + +Snapshot -- HBA/Target/LUN (ql-hba-snapshot) +Works on sysfs to display details about the QLogic HBA attached to the system. + +Set Device Command Timeout Value (ql-set-cmd-timeout) +Allows you to set the timeout on the devices connected to the QLogic FC HBA. + +Dynamic Target and LUN Discovery (ql-dynamic-tgt-lun-disc) +Scans for newly added LUNs. + +LUN Transition -- Offline to Online (ql-lun-state-online) +Allows you to change the state of LUNs connected to QLogic HBA from offline to +online/running. + + -- Matthias Schmitz Fri, 15 Aug 2008 23:33:33 +0200 --- qla-tools-0.20090725.orig/debian/ql-dynamic-tgt-lun-disc.8 +++ qla-tools-0.20090725/debian/ql-dynamic-tgt-lun-disc.8 @@ -0,0 +1,58 @@ +.TH "ql-dynamic-tgt-disc" "8" "July 2009" "Matthias Schmitz " "System Administration" +.SH "NAME" +ql\-dynamic\-tgt\-lun\-disc \- Scans for newly added LUNs. + +.SH "SYNOPSIS" +.B ql\-dynamic\-tgt\-lun\-disc +[\fIOPTIONS\fR] +.SH "DESCRIPTION" +Dynamic TGT\-LUN Discovery Utility + +This utility scans for newly added LUNs. After adding new LUNs, you +do not need to unload, then load the QLogic FC driver or reboot the +system +.PP +To begin scanning the LUNs issue following command: +.IP +# /usr/sbin/ql\-dynamic\-tgt\-lun\-disc +.TP +\fB\-al\fR, \fB\-\-allow\-lip\fR +LIP is not issued by default, even if it is required for scanning new LUNs +Setting this option, allows the utility to issue LIP. +.TP +\fB\-cl\fR, \fB\-\-current\-luns\fR +Displays LUNS currently present +.TP +\fB\-e\fR, \fB\-\-extended\-scan\fR +Use this option as "\-e | \fB\-\-extended\-scan\fR". to rescan +LUNs. This will identify any change in attributes of +existing LUNs. This option can be used in combination +of scan/refresh or max luns +.TP +\fB\-h\fR, \fB\-\-help\fR, ? +Prints this help message +.TP +\fB\-i\fR, \fB\-\-interactive\fR +Use this option to use the menu driven program +.TP +\fB\-is\fR, \fB\-\-iscsi\fR +Use this option to operate on ISCSI HBAs, this option can +be used in combination of any other supported option. +.TP +\fB\-m\fR, \fB\-\-max\-lun\fR +To set the maximum LUNs to be scanned +.TP +\fB\-p\fR, \fB\-\-proc\fR +Use PROC file system for LUN scanning +.TP +\fB\-r\fR, \fB\-\-refresh\fR +To refresh, that is remove LUNs that are lost +use the options "\-r|\-\-refresh". This will +remove the LUNs which no more exist. +.TP +\fB\-s\fR, \fB\-\-scan\fR [ \fB\-r\fR|\-\-refresh ] +The QLogic LUN scan utility re\-scans all the +devices connected to the QLogic HBA +.PP +.SH "SEE ALSO" +ql\-lun\-state\-online(8), ql\-hba\-snapshot(8), ql\-set\-cmd\-timeout(8) --- qla-tools-0.20090725.orig/debian/ql-lun-state-online.8 +++ qla-tools-0.20090725/debian/ql-lun-state-online.8 @@ -0,0 +1,38 @@ +.TH "ql-lun-state-online" "8" "August 2008" "Matthias Schmitz " "System Administration" +.SH "NAME" +ql\-lun\-state\-online \- scans for all offline LUNs and enables them. +.SH "SYNOPSIS" +.B ql\-lun\-state\-online +[\fIOPTIONS\fR] +.SH "DESCRIPTION" +QLogic Linux LUN STATE Change Utility + +This utility allows you to change the state of LUNs connected to a +QLogic HBA from offline to online/running. The SCSI mid\-layer may +change a device's state to offline when it does not receive a response +from the device. Once these devices are offline, the SCSI mid\-layer +ignores them +.PP +OPTIONS : +.IP +HOST NUMBER/S +.IP +The QLogic LUN STATE change utility +scans for all offline LUNs on the +Specified HOSTS and enables them +.HP +\fB\-a\fR, \fB\-\-all\fR +.IP +The QLogic LUN STATE change utility +enables all disabled LUNS +.HP +\fB\-i\fR, \fB\-\-interactive\fR +.IP +Use this option to use the menu driven program +.HP +\fB\-h\fR, \fB\-\-help\fR, ? +.IP +Prints this help message +.PP +.SH "SEE ALSO" +ql\-dynamic\-tgt\-lun\-disc(8), ql\-hba\-snapshot(8), ql\-set\-cmd\-timeout(8) --- qla-tools-0.20090725.orig/debian/control +++ qla-tools-0.20090725/debian/control @@ -0,0 +1,19 @@ +Source: qla-tools +Section: admin +Priority: optional +Maintainer: Christoph Goehre +Build-Depends: debhelper (>= 7.0.0) +DM-Upload-Allowed: yes +Standards-Version: 3.8.2 +Homepage: http://driverdownloads.qlogic.com/QLogicDriverDownloads_UI/SearchByProduct.aspx?ProductCategory=39&Product=936&Os=26 + +Package: qla-tools +Architecture: all +Depends: ${shlibs:Depends}, ${misc:Depends} +Description: QLogic Linux tools for work with QLogic HBAs + QLogic provides some tools that makes LUN handling (add / remove) and + adminstration of QLogic HBAs much easier. You can scan for newly added LUNs, + display details about the QLogic HBA attached to the system, change the state + of LUNs from offline to online/running and set the timeout on the devices + connected to the QLogic FC HBA. + --- qla-tools-0.20090725.orig/debian/ql-set-cmd-timeout.8 +++ qla-tools-0.20090725/debian/ql-set-cmd-timeout.8 @@ -0,0 +1,40 @@ +.TH "ql-set-cmd-timeout" "8" "August 2008" "Matthias Schmitz " "System Administration" +.SH "NAME" +ql\-set\-cmd\-timeout \- set the timeout on the devices connected to the QLogic FC HBA. +.SH "SYNOPSIS" +.B ql\-set\-cmd\-timeout +[\fIOPTIONS\fR] +.SH "DESCRIPTION" +QLogic Linux Set Device Timeout Utility + +This utility allows you to set the timeout on the devices connected to +the QLogic FC HBA. +This timeout value applies to the commands sent to the device. This +can help when target devices take longer to execute a command, for +example under heavy I/O. Setting a longer timeout reduces the chance +of the Linux SCSI mid\-layer driver aborting the tasks after a timeout. +.IP +[DEFAULT] +.IP +Display timeout of devices connected to all HOSTs +.IP +[HOST] +.IP +Display timeout of devices connected to HOST +.IP +[HOST] [TARGET] +.IP +Display timeout of devices connected to a TARGET on HOST +.IP +[HOST] [TARGET] [TIMEOUT] +.IP +To set timeout on devices connected to a TARGET on HOST +.TP +\fB\-h\fR, \fB\-\-help\fR, ? +Prints this help message +.TP +\fB\-i\fR, \fB\-\-interactive\fR +Use this option to use the menu driven program +.SH "SEE ALSO" +ql\-dynamic\-tgt\-lun\-disc(8), ql\-lun\-state\-online(8), ql\-hba\-snapshot(8) +