rpms/pilot-link/devel README.fedora, NONE, 1.1 60-pilot.rules, NONE, 1.1 60-pilot.perms, NONE, 1.1 pilot-link.spec, 1.67, 1.68

Mon Jan 7 23:55:24 UTC 2008

Author: alexlan

Update of /cvs/pkgs/rpms/pilot-link/devel
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1967

Modified Files:
	pilot-link.spec 
Added Files:
	README.fedora 60-pilot.rules 60-pilot.perms 
Log Message:
* Mon Jan  7 2008 Alex Lancaster <alexlan[AT]fedoraproject org> - 2:0.12.3-4
- Synchronize with F-8 branch: 
- Add README.fedora and visor configs as fallbacks (#280251: thanks Kevin Page)
- Don't tag HAL/PolicyKit files as %config (#427840)
- Remove visor module if currently loaded (#280251)

--- NEW FILE README.fedora ---
Additional information for Fedora pilot-link users
==================================================

pilot-link-0.12.2-10.fc8 and later versions are configured to enable 
the use of libusb for console users - permissions are now handled by
PolicyKit. For more information on libusb see README.libusb.

IMPORTANT:

If your Palm device is plugged in at the time of the upgrade (or you
are experiencing difficuly with having the Palm device recognized) you
should probably unplug and replugin in your device after the upgrade
for the new HAL configuration to take effect.

pilot-link libusb support is relatively new and may still be 
incompatible with some handheld devices. If you experience such a
problem you may want to try the older "visor module" USB method 
described below. If possible please report device incompatibility to:
https://bugzilla.redhat.com/show_bug.cgi?id=280251


Visor module setup
------------------

The Visor module is a backwards compatibility solution to expose the USB
connection of newer Palm handhelds as a serial device, which is what
older versions of pilot-link and dependent packages require to work.

Unfortunately this solution is inherently imperfect when used with udev
(as Fedora does) - you may have to tweak your individual setup.

1) disable libusb: remove (or comment out the contents) of
/etc/modprobe.d/blacklist-visor

2) Configure udev to detect the Palm and create /dev/pilot: copy
60-pilot.rules from /usr/share/pilot-link/udev/ to /etc/udev/rules.d/

3) Configure permissions so that a console user can access /dev/pilot:
copy 60-pilot.perms from /usr/share/pilot-link/udev/ to
/etc/security/console.perms.d/

For a discussion of the inherent problems related to the Visor module,
see:
https://bugzilla.redhat.com/show_bug.cgi?id=158809


Old serial (non-USB) handhelds
------------------------------

Older serial (non-USB) handhelds can be directly addressed by pilot link
on their serial port (e.g. /dev/ttyS0) or /dev/pilot can be symlinked to
the serial port.

Kevin R. Page, 2007-12-11
Alex Lancaster, 2008-01-07


--- NEW FILE 60-pilot.rules ---
BUS=="usb", SYSFS{product}=="Palm Handheld*|Handspring*",KERNEL=="ttyUSB*",NAME="ttyUSB%n", SYMLINK="pilot", GROUP="uucp", MODE="0660"


--- NEW FILE 60-pilot.perms ---
<ttyUSB>=/dev/ttyUSB*
<console>  0660 <ttyUSB> 0660 root.uucp


Index: pilot-link.spec
===================================================================
RCS file: /cvs/pkgs/rpms/pilot-link/devel/pilot-link.spec,v
retrieving revision 1.67
retrieving revision 1.68
diff -u -r1.67 -r1.68
--- pilot-link.spec	4 Jan 2008 08:43:15 -0000	1.67
+++ pilot-link.spec	7 Jan 2008 23:54:50 -0000	1.68
@@ -3,7 +3,7 @@
 
 Name: pilot-link
 Version: 0.12.3
-Release: 3%{?dist}
+Release: 4%{?dist}
 Epoch: 2
 License: GPLv2 and GPLv2+ and LGPLv2+ and TCL
 Group: Applications/Communications
@@ -14,6 +14,9 @@
 Source1: 19-pam-acl-management.fdi
 Source2: pilot-device-file.policy
 Source3: blacklist-visor
+Source4: README.fedora
+Source5: 60-pilot.perms
+Source6: 60-pilot.rules
 
 ExcludeArch: s390 s390x
 #Patch1: pilot-link-0.11.0-perlmd5.patch  # May be still applied
@@ -23,7 +26,8 @@
 Patch6: pilot-link-0.12.2-open.patch
 Patch7: pilot-link-0.12.3-md5.patch
 
-Requires: /sbin/ldconfig
+Requires(post): /sbin/ldconfig, /sbin/modprobe
+Requires(postun): /sbin/ldconfig
 
 %if %{support_perl}
 Requires:      perl(:MODULE_COMPAT_%{perl_version})
@@ -55,6 +59,7 @@
 Requires: libpng-devel
 Requires: readline-devel
 
+
 %description devel
 This package contains the development headers that are used to build
 the pilot-link package. It also includes the static libraries
@@ -145,16 +150,29 @@
 mkdir -p %{buildroot}%{_sysconfdir}/modprobe.d/
 install -p -m644 %{SOURCE3} %{buildroot}%{_sysconfdir}/modprobe.d/blacklist-visor
 
-%post -p /sbin/ldconfig
+# put README.fedora into tree
+cp %{SOURCE4} README.fedora
+
+# install visor configs to share/udev
+install -p -m644 %{SOURCE5} %{buildroot}%{_datadir}/pilot-link/udev
+install -p -m644 %{SOURCE6} %{buildroot}%{_datadir}/pilot-link/udev
+
+%post 
+/sbin/ldconfig
+if [ $1 = 2 ]; then
+# only attempt to remove visor module on upgrade, not needed for fresh install
+   /sbin/modprobe -s -r visor > /dev/null 2>&1
+fi
 
-%postun -p /sbin/ldconfig
+%postun
+/sbin/ldconfig
 
 %clean
 rm -rf %{buildroot}
 
 %files
 %defattr(-,root,root,-)
-%doc COPYING ChangeLog README NEWS doc/README.usb doc/README.debugging doc/README.libusb
+%doc COPYING ChangeLog README NEWS doc/README.usb doc/README.debugging doc/README.libusb README.fedora
 %{_libdir}/*.so.*
 %if %{support_perl}
 %{perl_vendorarch}/auto/*
@@ -163,8 +181,8 @@
 %{_bindir}/*
 %{_datadir}/pilot-link
 %{_mandir}/man?/*
-%config(noreplace) %{_datadir}/hal/fdi/policy/10osvendor/19-pam-acl-management.fdi
-%config(noreplace) %{_datadir}/PolicyKit/policy/pilot-device-file.policy
+%{_datadir}/hal/fdi/policy/10osvendor/19-pam-acl-management.fdi
+%{_datadir}/PolicyKit/policy/pilot-device-file.policy
 %config(noreplace) %{_sysconfdir}/modprobe.d/blacklist-visor
 
 %files devel
@@ -175,6 +193,12 @@
 %{_datadir}/aclocal/*.m4
 
 %changelog
+* Mon Jan  7 2008 Alex Lancaster <alexlan[AT]fedoraproject org> - 2:0.12.3-4
+- Synchronize with F-8 branch: 
+- Add README.fedora and visor configs as fallbacks (#280251: thanks Kevin Page)
+- Don't tag HAL/PolicyKit files as %config (#427840)
+- Remove visor module if currently loaded (#280251)
+
 * Fri Jan  4 2008 Alex Lancaster <alexlan[AT]fedoraproject org> - 2:0.12.3-3
 - Synchronize with F-8 branch: add HAL, PolicyKit rules (#280251)
 


