Konfigurační soubor pro SMBD

• Formát souboru

  Soubor se skládá ze "sekcí" a "parametrů".
  
  Sekce začíná jménem sekce, uzavřeným do hranatých závorek a pokračuje až do začátku další sekce. V sekcích jsou uváděny parametry.
  
  Parametry jsou tvaru jméno_parametru = hodnota. Hodnota je bud znakového typu (nejsou potřeba uvozovky) nebo typu boolean (hodota je 1/0 nebo true/false nebo yes/no)
  
  Soubor je členěn po řádcích, takže každý nový řádek znamená jméno sekce, parametr nebo poznámku.
  Poznámky začínají znakem ";".
  
  
  Každá sekce popisuje jednu službu. Uvnitř sekce se specifikují parametry platné pro tuto službu.
  
  Jsou definovány tři speciální jména sekcí:
  
  [global]
  parametry platné pro celý server, případně defaultní hodnoty pro jednotlivé sekce. Parametry označené (G) lze specifikovat pouze v této sekci.
  
  [homes]
  tato služba umožňuje zpřístupnění home adresářů. Pokud má uživatel definován domovský adresář, jméno této služby se změní na jeho uživatelské jméno a nastaví na jeho domovský adresář. Pokud je zde definován parametr path=, lze použít makro %S pro získání jména uživatele.
  
  [printers]
  tato služba funguje podobně jako [homes], ale pro tiskárny. Pokud je tato sekce specifikována, uživatelé se mohou připojit k libovolné tiskárně v printcap. Pokud je požadována služba, jejíž jméno není specifikováno v smb.conf a zároveň existuje sekce [printers], je jméno této služby porovnáno proti tiskárnám v printcap a pokud je nalezena, je vytvořena služba s tímto jménem. Tato sekce musí mít nastavený parametr printable.
  
  

  
  

• Makra

  Lze používat následující makra pro dynamické generování např. zpráv nebo pro přidělení home adresáře (viz sekce [homes] výše). Definovaná makra:
  
  

  %S	jméno aktuální služby
  %P	kořenový adresář aktuální služby
  %u	uživatelské jméno
  %g	primární skupina uživatele %u
  %U	přidělené uživatelské jméno (parametr users, guest account, ...)
  %G	primární skupina %U
  %H	domovský adresář uživatele %u
  %v	verze Samby
  %h	jméno stroje, na kterém Samba běží
  %m	netbios jméno klientského stroje
  %L	netbios jméno serveru
  %M	internetová adresa klienta
  %N	jméno domovského NIS serveru (pokud neexistuje, stejné jako %L)
  %R	zvolený protokol po handshake (jeden z CORE, COREPLUS, LANMAN1, LANMAN2 nebo NT1)
  %d	ID procesu serveru
  %a	architektura vzdáleného stroje, rozeznává se Samba, WfWg, WinNT a Win95
  %I	IP adresa klienta
  %T	aktuální datum a čas

  
  

  
  

• Vlastní parametry

  
  

  admin users (S)	Seznam uživatelů, kteří mohou provádět souborové operace bez omezení (root) default žádní
  announce as (G)	Nastavuje, jak se bude hlásit nmbd - hodnoty jsou jedna z "NT", "Win95", "WfW" default NT
  announce version (G)	Nastavuje verzi, jakou se má nmbd hlásit. default 4.2
  auto services (G)	Automaticky přiřadí specifikované služby do browse listu (užitečné pro automatické sekce [homes] a [printers], které nemusí být vidět).
  allow hosts (S)	Jména (popř IP adresy) strojů, ze kterých je povoleno připojení k službám. Lze použít * pro libovolný řetězec a slovo EXCEPT. default žádné
  alternate permissions (S)	Nastavuje, jak vytvářet DOSový ReadOnly bit. Pokud je nastaven na false, je RO nastaven tam, kde uživatel nemá práva (UNIXová) zapsat do souboru. Pokud je false, nastaví se RO bit není-li v UNIXu nastaven w bit pro uživatele. Vhodné např. při kopírování cizích souborů - nastavoval by se RO flag. default no
  available (S)	Znepřístupnění služby. default yes
  bind interfaces only (G)	Nastavuje, na kterých interface má Samba poslouchat. Pokud je true, poslouchá se jen na interface specifikovaných parametrem interfaces default false
  browseable (S)	Nastavuje, jestli má být služba viditelná v browse listu. default true
  case sensitive (G)	Pokud je true, rozlišuje Samba velká a malá písmena. default false
  character set (G)	Nastavuje převádění z kódové stánky 850 DOSu na ISO8859-1 nebo ISO8859-2. default žádné
  client code page (G)	Nastavuje kódovou stránku klienta. Hodnota může být 437 nebo 850. default 850
  comment (S)	Poznámky ke službě - klient může zobrazovat. default žádné
  config file (G)	Lze nastavit jméno konfiguračního souboru. Pokud je nastaven, všechny parametry jsou znovu načteny z tohoto souboru. Lze používat substituce, což může být dobré např. pro různé konfigurace podle stroje na kterém Samba běží.
  copy (S)	Vytvoří kopii služby. Nová služba je jen jakýsi link.
  create mask (S)	Nastavení masky pro vytvářené soubory. Bity, které nejsou nastaveny, jsou mazány (narozdíl od UNIXového umask). default 0744
  create mode (S)	Alias pro create mask.
  dead time (G)	Počet minut, kdy je klient neaktivní, po kterých je klient odpojen. 0 znamená vypnuto. default 0
  debug level (G)	Nastavení množství zpráv zapisovaných do log souborů. default parametr -d na příkazové řádce
  default (G)	Alias pro default service.
  default case (S)	Nastavuje, zda nové soubory budou uloženy velkými písmeny (upper) nebo malými (lower) default lower
  default service (G)	Specifikuje, ke které službě se připojit, pokud požadovanou službu nelze najít. default pub
  delete readonly (S)	Nastaví, zda lze smazat RO soubory.
  deny hosts (S)	Alias pro allow hosts.
  delete veto files (S)	Nastavuje, zda je povoleno smazat adresář, obsahující nějaké veto soubory. default False
  dfree command (G)	Pokud jsou nějaké problémy se zjišťováním velikosti volného místa na disku pomocí interních rutin Samby, lze zadat jméno externího programu pro zjišťování volného místa. default žádný
  directory (S)	Alias pro path.
  directory mask (S)	Nastavení masky pro vytvářené adresáře. Bity, které nejsou nastaveny, jsou mazány (narozdíl od UNIXového umask). default 0755
  directory mode (S)	Alias pro directory mask.
  dns proxy (G)	Nastavuje, zda se má pokoušet nmbd neznámé NetBios jméno najít jako doménové jméno DNS. Může na dobu potřebnou k dotazu na DNS zablokovat nmbd. default yes
  domain logons (G)	Pokud je nastaveno na true, bude Samba obsluhovat přihlášení Win95 do workgroup, ve které jsou. default false
  domain master (G)	Nastavit Sambu tak, aby pracovala jako nadřazený browse master. default no
  dont descend (S)	Seznam adresářů (oddělený čárkami), do kterých není povolen přístup - budou se zobrazovat prázdné. Např. v Linuxu /proc. default žádné
  dos filetimes (S)	Určuje, jak se bude měnit čas poslední modifikace a přístupu k souboru. Pokud je false je nechána UNIXová implementace. default false
  encrypt passwords (G)	Nastavuje, zda používat kódovaná hesla. Lze použít pouze pokud byla Samba zkompilována s potřebnými knihovnami pro kódování. default false
  exec (S)	Alias pro preexec.
  fake oplocks (S)	Pokud je zapnut, každému klientu se nastaví zámek na soubor, takže klient může používat svou cache. Pokud se použije na RW souborech, může dojít k poškození dat. default false
  follow symlinks (S)	Nastavuje, zda Samba má procházet symbolické linky. default true
  force create mode (S)	Všechny bity uvedené tímto parametrem jsou vždy nastaveny pro vytvářený soubor. default 000
  force directory mode (S)	Všechny bity uvedené tímto parametrem jsou vždy nastaveny pro vytvářený adresář. default 000
  force group (S)	Nastavuje jméno skupiny, pod kterou jsou prováděny všechny operace. default žádná
  force user (S)	Nastavuje jméno uživatele, pod kterým jsou prováděny všechny operace. Klient se však musí před použitím služby normálně identifikovat (jméno/heslo). default žádný
  getwd cache (G)	Zapne cache Samby pro volání getwd(). default false
  group (S)	Alias pro force group.
  guest account (S)	Pod jakým uživatelským jménem provádět služby označené jako guesk ok default specifikován při kompilaci
  guest ok (S)	Alias pro public.
  guest only (S)	Jsou povoleny pouze "guest" připojení. default false
  hide dot files (S)	Nastavuje, zda soubory začínající tečkou jsou nastaveny jako Hidden. default true
  hide files (S)	Seznam souborů, které se nemají zobrazovat při výpisu adresáře, ale jsou přístupné. Lze použít * a ?. Jména souborů jsou oddělena /. Nesmí obsahovat cestu. default žádné
  homedir map (G)	Pokud je zapnuta volba nis homedir, udává mapu, ze které se extrahují domovské adresáře. default auto.home
  hosts allow (S)	Alias pro allow hosts.
  hosts deny (S)	Alias pro deny hosts.
  hosts equiv (G)	Jméno souboru, ze kterého se načtou dvojice stroj-login, kteří se nemusejí autorizovat heslem. default žádný
  include (G)	Vloží jiný soubor. Lze použít substituce kromě %u, %P a %S.
  interfaces (G)	Nastavuje na kterých interfaces se má Samba hlásit. Zadávají se ve tvaru IP/netmask.
  invalid users (S)	Jména uživatelů, kteří se nemůžou připojit k této službě. Začíná-li jméno @ je interpretováno jako jméno skupiny.
  keep alive (G)	Nastavuje počet sekund mezi KEEPALIVE packety - zjišťují, zda klient ještě reaguje. 0 znamená vypnutí. default 0
  lm announce (G)	Nastavuje, zda produkovat Lanman announce broadcast vyžadovaných OS/2 klienty. default auto
  lm interval (G)	Jak často vyslat lm announce broadcast v sekundách. default 60
  load printers (G)	Zda nahrát všechny tiskárny z printcap pro browse. default true
  local master (G)	Nastavení Samby jako lokálního master browseru. default true
  lock directory (G)	Ve kterém adresáři ukládat zamykací soubory. default /tmp/samba
  locking (S)	Nastavuje, zda má Samba vytvářet a obsluhovat zámky požadované klienty. Pokud nastaveno na false, každý zámek je úspěšný a fronta zámků je prázdná. default yes
  log file (G)	Jméno logovacího souboru, lze použít substituce.
  log level (G)	Alias pro debug level.
  logon drive (G)	Nastavuje cestu, ke které se připojí domovské adresáře. Požíváno pouze Win NT Wrks.
  logon home (G)	Umístění domovského adresáře. Pouze pro Win95 nebo WinNT Wrks. default \\%N\%U
  logon path (G)	Cesta k uživatelským prifilům. default \\%N\%U\profile
  logon script (G)	Jméno dávkového souboru (.bat nebo .cmd), který se má spustit na klientově straně při přihlášení. Řádky musí být ukončeny CRLF.
  lppause command (S)	Příkaz pro zastavení tisku nebo spoolingu tiskové úlohy.
  lpq cache time (G)	Jak dlouho má být uložena informace o tisku v cache Samby, aby se nemusel volat lpq moc často. default 10
  lpq command (S)	Jaký příkaz spustit pro zjištění stavu tisku. V makru %p je jm0no tiskárny. default zaleží na parametru printing.
  lpresume command (S)	Jakým příkazem restartovat nebo pokračovat v přerušeném tisku. V makrech %p je jméno tiskárny a v %j číslo úlohy.
  lprm command (S)	Jakým příkazem vymazat úlohu z tiskové fronty. V makrech %p je jméno tiskárny a v %j číslo úlohy. default zaleží na parametru printing.
  magic output (S)	Jméno souboru, do kterého se uloží výstup magic script.
  magic script (S)	Jméno souboru, do kterého se po otevření napíše shellovský script a po zavření je vykonán. Umožňuje spustit na serveru script. default žádné (tato funkce je vypnuta)
  mangle case (S)	Zda měnit zadaná jména na defaultní velikost. default false
  mangled map (S)	Jak měnit jména souborů v UNIXu, která nejsou zobrazitelná v DOSu. příkladmangled map = (*.html *.htm) default žádná
  mangled names (S)	Nastavuje, zda překonvertovat jméno tak, aby bylo zobrazitelné v DOSu (true) nebo jméno ignorovat a nezobrazit (false). default true
  mangling char (S)	Magický znak, kterým zkrátíme jméno souboru na 5 znaků a připojíme číslo. default ~
  mangled stack (G)	Počet konvertovaných jmen v cache Samby. default 50
  map archive (S)	Nastavuje, zda mapovat DOSový atribut Archive jako eXecute bit uživatele. default true
  map hidden (S)	Nastavuje, zda mapovat DOSový atribut Hide jako eXecute bit others. default false
  map system (S)	Nastavuje, zda mapovat DOSový atribut System jako eXecute bit skupiny. default false
  max connections (S)	Maximální počet současných připojení ke službě. 0 - neomezeno. default 0
  max disk size (G)	Nastavuje maximální volné místo, které se bude zobrazovat. 0 - neomezovat. default 0
  max log size (G)	Maximální velikost v kB log souboru. Při překročení, Samba starý log soubor přejmenuje na .old a vytvoří nový. 0 - neomezeno. default 5000
  max packet (G)	Alias pro packet size.
  max ttl (G)	Maximální ttl nmbd při zjišťování NetBios jména. default 14400
  max wins ttl (G)	Maximální trvanlivost NetBios jména v tabulkách Samby v sekundách. default 259200
  max xmit (G)	Maximální velikost paketu. Číslo z rozsahu 1-65535. default 65535
  message command (G)	Nastavuje, jaký příkaz spustit, když na server přijde WinPopup zpráva.
  min print space (S)	Minimální volné místo na disku, aby se povolil tisk. default 0
  min wins ttl (G)	Minimální trvanlivost NetBios jména v tabulkách Samby v sekundách. default 21600
  netbios aliases (G)	Aliasy, pod kterými je znám tento server.
  netbios name (G)	NetBios jméno serveru.
  nis homedir (G)	Nastaví home share server z NIS mapy. default false
  null passwords (G)	Povolí účty s prázdnými hesly. default false
  only guest (S)	Alias pro guest only.
  only user (S)	Nastavuje, zda se mohou příhlásit i uživatelé neuvedení v parametru user. default false
  oplocks (S)	Zapnutí zamykání souborů klienty. Může zvýšit výkonnost serveru. default true
  os level (G)	Jakým levelem se prokazuje Samba při službě browse.
  passwd chat (G)	Jakým způsobem probíhá konverzace při změně hesla. Jsou to dvojice "vysílá"-"očeekává". Makra %o a %n jsou nahrazeny starým a novým heslem. default *old*password* %o\n *new*password* %n\n *new*password* %n\n *changed*
  passwd program (G)	Jméno programu pro změnu hesla. default /bin/passwd
  password level (G)	Počet velkých písmen v hesle. Tento parametr způsobí, že pokud selhalo ověření hesla, vyzkouší se ještě všechny možnosti, které mají zadaný počet velkých písmen. Např. je-li zadáno heslo "FRED" a tento parametr je 1, pak selže-li heslo FRED, zkusí se ještě Fred, fRed,frEd,freD,fred. default 0
  password server (G)	Nastaví, aby se ověřování hesla dělalo na vzdáleném storoji.
  path (S)	Tento parametr nastavuje cestu, kterou zpřístupňuje daná služba, případně spool adresář pro tiskovou službu (měl by mít nastavený write pro others a sticky bit) default žádná
  postexec (S)	Nastaví příkaz, který se má spustit po odhlášení klienta (např. pro odmountování cdrom a pod.) default žádný
  postscript (S)	Nastavení tiskárny jako postscriptové. Přidá %! na začátek každé úlohy. default false
  preexec (S)	Příkaz, který se má spustit před přihlášením klienta. default žádný
  preferred master (G)	Nastaví Sambu jako preferovaný master browser pro svou doménu. default false
  preload (G)	Alias pro auto services.
  preserve case (S)	Nastavuje, zda bude velikost písmen zachována nebo zda se má nastavit defaultní velikost. default false
  print command (S)	Příkaz, který Samba zavolá po ukončení spoolingu do souboru, aby tento soubor vytiskl. Makro %s se rozexpanduje na jméno spool souboru a %p na jméno tiskárny. default lpr -r -P %p %s
  print ok (S)	Alias pro printable.
  printable (S)	Nastavuje službu jako tiskárnu, tj. klient může otevírat, zapisovat a posílat spool soubory do adresáře nastaveného pro tuto službu. default false
  printcap name (G)	Umístění printcap konfiguračního souboru. default /etc/printcap
  printer (S)	Nastavuje jméno tiskárny, na které se budou tisknout úlohy z této fronty. default lp
  printer driver (S)	Nastavuje, jaký řídící řetězec má dostat klient při dotazu na driver tiskárny.
  printer name (S)	Alias pro printer.
  printer driver file (G)	Nastavuje jméno souboru, ve kterém jsou uloženy definice tiskáren. default žádný
  printer driver location (S)	Nastavuje, kde má klient hledat driver pro tiskárnu, aby si je mohl nainstalovat. default žádná
  printing (S)	Nastavuje, jak jsou interpretovány informace o stavu tiskárny a také ovlivňuje defaultní hodnoty některých parametrů. Lze nastavit jeden z: bsd, sysv, hpux, aix, qnx a plp.
  protocol (G)	Nejvyšší protokol, kterým je Smaba ochotna komunikovat. Možné hodnoty jsou: CORE, COREPLUS, LANMAN1, LANMAN2 a NT1. default NT1
  public (S)	Pokud je nastaven na true, není nutné heslo pro připojení k této službě. default false
  read list (S)	Seznam uživatelů, kterým je nastaven read-only přistup. Pokud jméno začíná @, je považováno za jméno skupiny. default prázdný
  read only (S)	Opačný alias pro writable.
  read prediction (G)	Zapíná čtení napřed pro zrychlení práce serveru. default false
  read raw (G)	Nastavuje, zda má Samba podporovat dlouhé čtení při posílání dat klientovi. Umožňuje poslat paket s až 65535B dat. default true
  read size (G)	Nastavuje, při jakém množství příkazů pro zápis se mají vyprázdnit zápisové buffery Samby. default 2048
  remote announce (G)	Nastavuje, kterým strojům se má Samba "připomínat". Vhodné pro vzdálenou workgroup, ve které nefungují normální browse služby korektně. Uvádí se ve tvaru IP adresa/jméno workgroup.
  remote browse sync (G)	Jména strojů, kterých se bude nmbd periodicky dotazovat na browse informace.
  revalidate (S)	Nastavuje, zda se pokusit o validaci login/heslo při přihlášení klienta k jiné službě, pokud již byl připojen k nejaké jiné. Pokud false, vždy vyžaduje přihlášení. default false
  root (G)	Alias pro root directory.
  root dir (G)	Alias pro root directory.
  root directory (G)	Server provede volání chroot na tento adresář. default /
  root postexec (S)	Podobné jako postexec, ale příkaz je spouštěn pod UID root.
  root preexec (S)	Podobné jako preexec, ale příkaz je spouštěn pod UID root.
  security (G)	Nastavuje, jakým způsobem bude Samba komunikovat s klienty o heslech. Možnosti jsou share, user a server. Pokud je nastaveno na "user", jsou jména a hesla porovnávány proti jménům a heslům z UNIXové strany. Pokud je parametr "server", Samba ověřuje hesla proti jinému stroji. default share
  server string (G)	Komentář serveru. default Samba %v
  set directory (S)	Nastavuje, zda lze použít příkaz setdir. default false
  shared mem size (G)	Nastavuje velikost sdílené paměti mezi procesy Samby. default 102400
  smb passwd file (G)	Nastavuje cestu k souboru s hesly pro Sambu. Pozor, velmi nebezpečné nechat write práva do tohoto souboru.
  smbrun (G)	Celá cesta k smbrun příkazu. default podle Makefile
  share modes (S)	Nastavování sdílení souborů. default true
  short preserve case (S)	Nastavuje, zda při krátkých jménech (8.3) zachovat velikost písmen. default false
  socket address (G)	Na které adrese má Samba poslouchat.
  socket options (G)	Nastavení voleb pro sockety mezi klientem a Sambou. Jedno z: SO_KEEPALIVE SO_REUSEADDR SO_BROADCAST TCP_NODELAY IPTOS_LOWDELAY IPTOS_THROUGHPUT SO_SNDBUF SO_RCVBUF SO_SNDLOWAT SO_RCVLOWAT
  status (G)	Zapíná logování připojení do souboru, který může číst smbstatus. default true
  strict locking (S)	Pokud je true, Samba kontroluje zámky při každém přístupu k souboru. Jinak kontroluje zámek jen, když se na něj klient zeptá. default false
  strip dot (G)	Nastavuje, zda odstraňovat tečky na konci jména. default false
  syslog (G)	Nastavuje frontu syslogu, do které se mapují debug informace. default 1
  syslog only (G)	Nastaví logování pouze do syslogu. default false
  sync always (S)	Nastavuje, zda volat sync při každém zápisu. default false
  time offset (G)	Počet minut, které se mají přidat k GMT na lokální čas konverzi. default 0
  time server (G)	Zapíná time server službu nmbd pro Win klienty. default false
  unix realname (G)	Pokud je true, Samba předává reálné jméno UNIXu klientovi. default false
  user (S)	Alias pro username.
  username (S)	Seznam uživatelů, proti kterým se má zkontrolovat zadané heslo. Vhodné pro Win95, které neumožňují zadat jiné uživatelské jméno. default guest účet pro guest služby jinak jméno služby
  username level (G)	Nastavuje, jak má Samba "hádat" uživatelské jméno. Parametr udává počet kombinací velkých písmen, které má Samba vyzkoušet. default 0
  username map (G)	Lze vytvořit různé aliasy pro jméno uživatele, např: root = admin administrator. Parametr uvádí jméno souboru s těmito aliasy. default žádný
  valid chars (S)	Nastavuje znaky, které jsou povoleny v názvech souborů a adresářů. Výčet se dělá pomocí ":", lze uvést i numerickou hodnotu. default podle nastavení systému
  valid users (S)	Jména uživatelů, kteří se mohou přihlásit. Pokud jméno začíná @ je jméno bráno jako jméno skupiny.
  veto files (S)	Jména souborů a adresářů, které nejsou ani viditelné ani přístupné.
  veto oplock files (S)	Vypíná oplocking pro specifikované soubory.
  volume (S)	Nastavuje jméno svazku, které se vrací klientovi.
  wide links (S)	Nastavuje, zda linky mimo adresářovou strukturu služby mají být procházeny. default true
  wins proxy (G)	Zapíná odpovídání na wins broadcast. default false
  wins server (G)	Jméno Wins serveru, u kterého se Samba má zaregistrovat.
  wins support (G)	Nastavuje nmbd jako Wins server. default false
  workgroup (G)	Jméno workgroup do které je server zařazen.
  writable (S)	Pokud je false, uživatel nemůže zapisovat ani modifikovat soubory v tomto podadresáři. default false
  write list (S)	Seznam uživatelů, kteří mají read-write přístup vždy. Pokud jméno začíná @ je jméno bráno jako název skupiny.
  write ok (S)	Alias pro writable.
  write raw (G)	Kontroluje, zda Samba přijímá raw pakety. default true