1Troubleshooting-FAQ:
2
3
4Contents:
5
6- Installed libmp4v2 or libgpod from source to /usr/local/lib, but
7  gtkpod is unable to locate libmp4.so.0 or libgpod.so.0
8
9- Files copied to gtkpod but they don't appear in the database (0.80,
10  Tony Williams)
11
12- Filenames on the iPod appear in DOS 8.3 format and syncing to the iPod
13  is not working as expected.
14
15- ./autogen.sh does not work
16
17- The following error message is displayed when accessing the device
18  (Markus Gaugusch, Justin Thiessen):
19     ieee1394: sbp2: aborting sbp2 command
20     Test Unit Ready 00 00 00 00 00
21
22- The following error message is displayed when accessing the device
23  (Ingo Reimann)
24     usb-storage: Attempting to get CSW...
25     usb-storage: usb_stor_bulk_transfer_buf: xfer 13 bytes
26     usb-storage: Status code -75; transferred 0/13
27
28- When connecting an iPod via USB to a 2.6 kernel machine the iPod will
29  be recognized but not work correctly. In /var/log/messages you'll
30  see the a bunch of "Buffer I/O error on device sd?" when connecting
31  the iPod (Jonas Bergler, Kevin Venkiteswaran)
32
33- SHUFFLE won't play music after reformatting (Mark Davis)
34
35- Calendar entries mixed up
36
37- m4a files created by faac cannot be added by gtkpod (gentoo)
38
39- gtkpod crashes when reading the iTunesDB (Fedora)
40
41- Problems connecting the iPod to Solaris/SPARC
42
43----------------------------------------------------------------------
44
45Installed libmp4v2 or libgpod from source to /usr/local/lib, but
46gtkpod is unable to locate libmp4.so.0 or libgpod.so.0
47
48
49If you install to /usr/local/lib please don't forget to add the path
50to LD_LIBRARY_PATH:
51
52     LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib
53     export LD_LIBRARY_PATH
54
55You can add those lines to your ~/.bashrc or add it globally to
56/etc/profile.
57
58----------------------------------------------------------------------
59Files copied to gtkpod but they don't appear in the database (0.80,
60Tony Williams)
61
62I'm having a problem that I wonder if you've seen.  I've setup
63gtkpod.  launch it and add files.  I can hear the ipod harddrive
64spin up.  If I go onto the ipod directly I can see the space being
65used and can even see the new files on the ipod.  However the ipod
66interface doesn't show the new files and gtkpod keeps telling me
67that there are orphaned files.
68
69Solution:
70
71I finally figured out the problem.  In my fstab I had the filesystem
72set to 'auto' and it was mounting as msdos instead of vfat.  I
73specified vfat in fstab and voila!  I'm a happy happy man.
74
75
76----------------------------------------------------------------------
77Filenames on the iPod appear in DOS 8.3 format and syncing to the iPod
78is not working as expected.
79
80Solution:
81
82You need to specify "vfat" as file system type. How to do that depends
83on which way you use to mount the iPod -- see the README file for more
84details.
85
86----------------------------------------------------------------------
87./autogen.sh does not work
88
89A ubunto user has reported that he had to set
90
91ACLOCAL_FLAGS=" -I /usr/share/aclocal/"
92
93in order to get ./autogen.sh to work.
94
95----------------------------------------------------------------------
96The following error message is displayed when accessing the device:
97
98     ieee1394: sbp2: aborting sbp2 command
99     Test Unit Ready 00 00 00 00 00
100
101Solution:
102
103(Markus Gaugusch):
104It is possible that hotplug and the "sg" support are not working well
105together. Try disabling "sg" support in the kernel configuration or
106unload the "sg" module if you are using modules.
107
108(Justin Thiessen):
109Forcing the sbp2 module to serialized I/O seems (so far) to have
110solved the problem.
111
112Ref.:
113------
114http://www.netzwerk-aktiv.com/pub/doc/newsletters/linux1394-user/html/1676.html
115http://www.ubuntuforums.org/printthread.php?t=6678
116http://66.102.7.104/search?q=cache:Xh_gu43y6w8J:themikecam.com/newmikecam/blog/index.php/geek/2005/+ipod+serialize_io&hl=en
117
118Looks like the driver is going to be set to default to serialized I/O
119in kernel 2.6.14, anyways.
120
121http://linuxtoday.com/developer/2005093001026NWKNDV
122
123
124----------------------------------------------------------------------
125The following error message is displayed when accessing the device
126
127     usb-storage: Attempting to get CSW...
128     usb-storage: usb_stor_bulk_transfer_buf: xfer 13 bytes
129     usb-storage: Status code -75; transferred 0/13
130
131Solution (by Ingo Reimann):
132
133I tried to use an iPod Mini with my nforce2-Board, kernel
1342.6.14/2.6.15 debian sid and got messages like [above] in
135dmesg. /dev/sda appeared, but fdisk -l did not show anything
136
137The solution, that i found in a discussion on
138http://kerneltrap.org/node/3844 was to unload ehci_hcd.
139
140
141----------------------------------------------------------------------
142When connecting an iPod via USB to a 2.6 kernel machine the iPod will
143be recognized but not work correctly. In /var/log/messages you'll see
144the a bunch of "Buffer I/O error on device sd?" when connecting the
145iPod (Jonas Bergler, Kevin Venkiteswaran)
146
147Solution (by "jeffmock"):
148
149Disable CONFIG_EFI_PARTITION (File Systems -> Partition Types ->
150Advanced Partition Selection -> EFI GUID Partition support) in your
151kernel configuration, recompile.
152
153Details can be found at
154http://www.linuxquestions.org/questions/showthread.php?postid=1197015#post1197015
155
156Excerpt:
157
158"This problem could potentially happen with both 2.4 and 2.6 kernels.
159
160A longer story follows and perhaps someone can come up with a more
161sensible solution for the long run.
162
163The iPod looks like a removable disk drive to the host computer. When it
164is attached to the computer, the mini iPod reports a capacity of 7999488
165512-byte sectors (or about 4GB). This turns out to be wrong for whatever
166reason. The mini iPod only really has 7999376 sectors and it exaggerates
167by 112 sectors. The other quality of the iPod is that if the computer
168attempts to read a sector greater than the actual capacity but less than
169the reported capacity, the iPod will dutifully report an I/O error, but
170it won't respond to any future requests until you unplug/plug the iPod."
171
172I followed the kernel recompile instructions for distro, disabled only
173the CONFIG_EFI_PARTITION option, and things ran perfectly for me
174afterwards. As indicated above, hopefully a better long-term solution
175will emerge soon."
176
177(Jorg Schuler: it seems a patch was introduced in kernel version 2.6.10:
178"<phil@ipom.com> [PATCH] USB Storage: Add unusual_devs entry for iPod
179This patch adds an unusual_devs.h entry for the Apple iPod as it
180reports one too many sectors. The patch was submitted by
181Avi Kivity <avi@argo.co.il> and re-diffed by me.")
182
183
184----------------------------------------------------------------------
185SHUFFLE won't play music after reformatting
186
187Solution (by Mark Davis):
188
189The SHUFFLE seems to care about the volume name which has to be
190"IPOD". Try to format as (replace /dev/sda1 with the appropriate
191device file for your SHUFFLE!):
192
193mkdosfs -F32 -n IPOD /dev/sda1
194
195
196----------------------------------------------------------------------
197Calendar entries mixed up
198
199The iPod does not appear to like times specified in UTC (indicated by
200a trailing 'Z'). KOrganizer seems to do this. If you know how to work
201around it let me know.
202
203
204----------------------------------------------------------------------
205m4a files created by faac cannot be added by gtkpod (gentoo)
206
207There appear to be some versions of faac that do not create 'good' m4a
208files. The problem could be solved under gentoo by using version 1.24.
209In order to make error tracking easier, more detailled error messages
210are displayed when tracks could not be added for any reason starting
211with version 0.91-CVS of gtkpod.
212
213
214----------------------------------------------------------------------
215gtkpod crashes when reading the iTunesDB (Fedora)
216
217It appears that crashes were observed with kernel version
2182.6.11-1.35_FC3. An upgrade to 2.6.12-1.1376_FC3 got rid of the
219problem. This was with gtkpod-0.94.0 and Athlon64 3000+.
220
221
222----------------------------------------------------------------------
223Problems connecting the iPod to Solaris/SPARC
224
225Current (as of 2006/03/30) versions of the Solaris pcfs SPARC driver
226have a bug where the correct filesystem/partition layout may not be
227recognized, and this is true for iPods.  This prevents the iPod
228partition from being mounted on Solaris SPARC.  In order to work
229around this, one must prevent pcfs from detecting the first FAT32
230filesystem, forcing it to move on to the second one.  This can be done
231by changing the filesystem identifier like so:
232
233# dd if=/dev/rdsk/c3t0d0s2 of=/tmp/ipod.orig count=1
234# cp /tmp/ipod.orig /tmp/ipod.modified
235<edit /tmp/ipod.modified and change the first occurance of "FAT32" (at
236offset 0x52 for me) to something else like "CAT32">
237# dd if=/tmp/ipod.modified of=/dev/rdsk/c3t0d0s2 count=1
238
239The above modification may or may not affect usage on other systems.
240Some reports encounter no problems using the iPod or iTunes after
241making it.  In my own experience, my iPod hard locked moving from a
242SPARC system to an x86 system, and I had to undo the change.  Wrapper
243scripts to handle this may be desirable on SPARC.
244
245Eric Enright