trying to get HEAD building again. If you want the code
[kai/samba.git] / docs / faq / FAQ-Install.html
1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 2. Compiling and installing Samba on a Unix host</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.60.1"><link rel="home" href="samba-faq.html" title="Samba FAQ"><link rel="up" href="samba-faq.html" title="Samba FAQ"><link rel="previous" href="FAQ-general.html" title="Chapter 1. General Information"><link rel="next" href="FAQ-ClientApp.html" title="Chapter 3. Specific client application problems"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Compiling and installing Samba on a Unix host</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="FAQ-general.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="FAQ-ClientApp.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="FAQ-Install"></a>Chapter 2. Compiling and installing Samba on a Unix host</h2></div></div><div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><a href="FAQ-Install.html#id2816137">My client reports &quot;cannot locate specified share name&quot; or similar</a></dt><dt><a href="FAQ-Install.html#id2816189">Why are my file's timestamps off by an hour, or by a few hours?</a></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2816137"></a>My client reports &quot;cannot locate specified share name&quot; or similar</h2></div></div><div></div></div><p>
2 This message indicates that your client CAN locate the specified
3 server, which is a good start, but that it cannot find a service of
4 the name you gave.
5 </p><p>
6 The first step is to check the exact name of the service you are
7 trying to connect to (consult your system administrator). Assuming it
8 exists and you specified it correctly (read your client's docs on how
9 to specify a service name correctly), read on:
10 </p><table class="simplelist" border="0" summary="Simple list"><tr><td>Many clients cannot accept or use service names longer than eight characters.</td></tr><tr><td>Many clients cannot accept or use service names containing spaces.</td></tr><tr><td>Some servers (not Samba though) are case sensitive with service names.</td></tr><tr><td>Some clients force service names into upper case.</td></tr></table></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2816189"></a>Why are my file's timestamps off by an hour, or by a few hours?</h2></div></div><div></div></div><p>
11 This is from Paul Eggert eggert@twinsun.com.
12 </p><p>
13 Most likely it's a problem with your time zone settings.
14 </p><p>
15 Internally, Samba maintains time in traditional Unix format,
16 namely, the number of seconds since 1970-01-01 00:00:00 Universal Time
17 (or ``GMT''), not counting leap seconds.
18 </p><p>
19 On the server side, Samba uses the Unix TZ variable to convert
20 internal timestamps to and from local time.  So on the server side, there are
21 two things to get right.
22 </p><table class="simplelist" border="0" summary="Simple list"><tr><td>The Unix system clock must have the correct Universal time. Use the shell command &quot;sh -c 'TZ=UTC0 date'&quot; to check this.</td></tr><tr><td>The TZ environment variable must be set on the server before Samba is invoked.  The details of this depend on the server OS, but typically you must edit a file whose name is /etc/TIMEZONE or /etc/default/init, or run the command `zic -l'.</td></tr></table><p>
23 </p><p>TZ must have the correct value.</p><p>
24 If possible, use geographical time zone settings
25 (e.g. TZ='America/Los_Angeles' or perhaps
26  TZ=':US/Pacific').  These are supported by most
27 popular Unix OSes, are easier to get right, and are
28 more accurate for historical timestamps.  If your
29 operating system has out-of-date tables, you should be
30 able to update them from the public domain time zone
31 tables at <a href="ftp://elsie.nci.nih.gov/pub/" target="_top">ftp://elsie.nci.nih.gov/pub/</a>.
32 </p><p>If your system does not support geographical timezone
33 settings, you must use a Posix-style TZ strings, e.g.
34 TZ='PST8PDT,M4.1.0/2,M10.5.0/2' for US Pacific time.
35 Posix TZ strings can take the following form (with optional
36                                                                                           items in brackets):
37 </p><pre class="programlisting">
38         StdOffset[Dst[Offset],Date/Time,Date/Time]
39 </pre><p>
40                 where:
41 </p><table class="simplelist" border="0" summary="Simple list"><tr><td>`Std' is the standard time designation (e.g. `PST').</td></tr><tr><td>`Offset' is the number of hours behind UTC (e.g. `8').
42 Prepend a `-' if you are ahead of UTC, and
43 append `:30' if you are at a half-hour offset.
44 Omit all the remaining items if you do not use
45 daylight-saving time.</td></tr><tr><td>`Dst' is the daylight-saving time designation
46 (e.g. `PDT').</td></tr><tr><td>The optional second `Offset' is the number of
47 hours that daylight-saving time is behind UTC.
48 The default is 1 hour ahead of standard time.
49 </td></tr><tr><td>`Date/Time,Date/Time' specify when daylight-saving
50 time starts and ends.  The format for a date is
51 `Mm.n.d', which specifies the dth day (0 is Sunday)
52 of the nth week of the mth month, where week 5 means
53 the last such day in the month.  The format for a
54 time is [h]h[:mm[:ss]], using a 24-hour clock.
55 </td></tr></table><p>
56 </p><p>
57 Other Posix string formats are allowed but you don't want
58 to know about them.</p><p>
59 On the client side, you must make sure that your client's clock and
60 time zone is also set appropriately.  [[I don't know how to do this.]]
61 Samba traditionally has had many problems dealing with time zones, due
62 to the bizarre ways that Microsoft network protocols handle time
63 zones.  
64 </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="FAQ-general.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="samba-faq.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="FAQ-ClientApp.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 1. General Information </td><td width="20%" align="center"><a accesskey="h" href="samba-faq.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. Specific client application problems</td></tr></table></div></body></html>