summaryrefslogtreecommitdiff
path: root/docs-xml/manpages
Commit message (Collapse)AuthorAgeFilesLines
* doc: update and tidy up the main samba(7) man pageBjoern Jacke2017-12-131-41/+39
| | | | | | | my favourite one here was "If you have access to a WWW viewer..." :) Signed-off-by: Bjoern Jacke <bjacke@samba.org> Reviewed-by: Andrew Bartlett <abartlet@samba.org>
* doc: remove section on ancient history of the docsBjoern Jacke2017-12-1314-113/+0
| | | | | | | This is quite historically, we should drop this. Signed-off-by: Bjoern Jacke <bjacke@samba.org> Reviewed-by: Andrew Bartlett <abartlet@samba.org>
* docs-xml/manpages: Use new doc.version XML entity.Karolin Seeger2017-12-1398-175/+177
| | | | | | | | | | | BUG: https://bugzilla.samba.org/show_bug.cgi?id=9531 Signed-off-by: Karolin Seeger <kseeger@samba.org> Reviewed-by: Stefan Metzmacher <metze@samba.org> Reviewed-by: Andreas Schneider <asn@samba.org> Autobuild-User(master): Andreas Schneider <asn@cryptomilk.org> Autobuild-Date(master): Wed Dec 13 17:22:01 CET 2017 on sn-devel-144
* source3: remove sock_execGary Lockyer2017-11-201-6/+0
| | | | | | | | | | | | | | | | | | | | | | | | Remove the sock_exec code which is no longer needed and additionally has been used by exploit code. This was originally test support code, the tests relying on the sock_exec code have been removed. Past exploits have used sock_exec as a proxy for system() matching a talloc destructor prototype. See for example: Exploit for Samba vulnerabilty (CVE-2015-0240) at https://gist.github.com/worawit/051e881fc94fe4a49295 and the Red Hat post at https://access.redhat.com/blogs/766093/posts/1976553 Signed-off-by: Gary Lockyer <gary@catalyst.net.nz> Reviewed-by: Andrew Bartlett <abartlet@samba.org> Reviewed-by: Garming Sam <garming@catalyst.net.nz> Autobuild-User(master): Andrew Bartlett <abartlet@samba.org> Autobuild-Date(master): Mon Nov 20 07:20:13 CET 2017 on sn-devel-144
* vfs: Remove aio_linuxVolker Lendecke2017-11-111-115/+0
| | | | | | | | | | | | Triggered by https://bugzilla.samba.org/show_bug.cgi?id=13128 I think this module should go. Once Linux aio will do what Samba needs, this might be worth another look. What we should instead do soon is support Linux preadv2 and the RWF_NOWAIT flag to avoid the thread context switch whenever possible. Signed-off-by: Volker Lendecke <vl@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* manpages: add vfs_nfs4acl_xattr.8Ralph Boehme2017-11-081-0/+134
| | | | | | | | Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org> Autobuild-User(master): Jeremy Allison <jra@samba.org> Autobuild-Date(master): Wed Nov 8 04:27:28 CET 2017 on sn-devel-144
* s3/posix_acls: add default ACL style "everyone"Ralph Boehme2017-11-082-2/+10
| | | | | | | | This synthesizes an ACL with a single ACE with full permissions for everyone. Not used for now, this comes later. Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* s3:Add a utimes command to smbclient so we can set the Windows times.Richard Sharpe2017-10-191-0/+8
| | | | | | | Add an update to the smbclient man page. Signed-off-by: Richard Sharpe <realrichardsharpe@gmail.com> Reviewed-by: Jeremy Allison <jra@samba.org>
* docs-xml: Fix a typo in manpage for vfs_fruitAnoop C S2017-10-161-1/+1
| | | | | | | | | Signed-off-by: Anoop C S <anoopcs@redhat.com> Reviewed-by: Volker Lendecke <vl@samba.org> Reviewed-by: Ralph Boehme <slow@samba.org> Autobuild-User(master): Ralph Böhme <slow@samba.org> Autobuild-Date(master): Mon Oct 16 15:55:35 CEST 2017 on sn-devel-144
* docs/vfs_fruit: Add Time Machine supportKevin Anderson2017-10-041-0/+28
| | | | | | | | | | | Add the capability to advertise FULLSYNC volume capabilities to clients that request them. This is mainly used for supporting Mac OS Time Machine backups from clients. The capability does not perform any additional action. Signed-off-by: Kevin Anderson <andersonkw2@gmail.com> Reviewed-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* vfs_snapper man page: Fixed typoMarc Muehlfeld2017-09-301-1/+1
| | | | | | | | | | This commit corrects a small typo in vfs_snapper manpage. Signed-off-by: Yvan Masson <yvan@masson-informatique.fr> Reviewed-by: Marc Muehlfeld <mmuehlfeld@samba.org> Autobuild-User(master): Marc Muehlfeld <mmuehlfeld@samba.org> Autobuild-Date(master): Sat Sep 30 02:41:46 CEST 2017 on sn-devel-144
* Remove misleading entry from vfs_streams_xattr man pageAnoop C S2017-09-051-4/+0
| | | | | | | | | | | The line which is being removed says that streams_xattr vfs module cannot be used when kernel oplocks is enabled. But the underlying bug(#7537) and another dependant bug(#12791) has been resolved sometime back. Signed-off-by: Anoop C S <anoopcs@redhat.com> Reviewed-by: Ralph Böhme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* scripts: Scripts to replay and generate samba trafficGary Lockyer2017-08-172-0/+766
| | | | | | | | | | | | | | | | | | | | | | | | Scripts to generate representative network traffic and replay this to a samba instance. For load testing, performance profiling and capacity planning. traffic_learner process a file generated by traffic_summary and generate a model that can be used by traffic_replay to generate samba network traffic. traffic_replay Replay a summary file generated by traffic_summary, or use a model created by traffic_learner to generate network traffic. Signed-off-by: Gary Lockyer <gary@catalyst.net.nz> Signed-off-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz> Reviewed-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz> Reviewed-by: Garming Sam <garming@catalyst.net.nz> Pair-programmed-with: Garming Sam <garming@catalyst.net.nz> Pair-programmed-with: Douglas Bagnall <douglas.bagnall@catalyst.net.nz> Pair-Programmed-With: Andrew Bartlett <abartlet@samba.org> Pair-Programmed-With: Tim Beale <timbeale@catalyst.net.nz>
* docs/vfs_fruit: remove period outside of the <para> tagRalph Boehme2017-07-291-1/+1
| | | | | | | | | | | | | | Period that is outside of the <para> tag causes unneccessary vertical space in the htmlman output. (Paragraph including only one period will be created.) From matsuand <michio_matsuyama@yahoo.co.jp>. Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Andrew Bartlett <abartlet@samba.org> Autobuild-User(master): Andrew Bartlett <abartlet@samba.org> Autobuild-Date(master): Sat Jul 29 15:09:37 CEST 2017 on sn-devel-144
* docs/smbget: Fix typo in options within man pageAnoop C S2017-07-271-2/+2
| | | | | | | | | | | | | `smbget` utility accepts '--user' as a valid argument. But still the man page specifies it as '--username'. So fixing the man page to reflect the current behaviour. Signed-off-by: Anoop C S <anoopcs@redhat.com> Reviewed-by: Martin Schwenke <martin@meltin.net> Reviewed-by: Andrew Bartlett <abartlet@samba.org> Autobuild-User(master): Jeremy Allison <jra@samba.org> Autobuild-Date(master): Thu Jul 27 06:35:10 CEST 2017 on sn-devel-144
* docs: Fix a typo in cifsdd.8Samba-JP oota2017-07-181-1/+1
| | | | | | | | | Signed-off-by: Samba-JP oota <ribbon@samba.gr.jp> Reviewed-by: Volker Lendecke <vl@samba.org> Reviewed-by: Ralph Böhme <slow@samba.org> Autobuild-User(master): Volker Lendecke <vl@samba.org> Autobuild-Date(master): Tue Jul 18 18:35:16 CEST 2017 on sn-devel-144
* vfs_fruit: add fruit:model = <modelname> parametric optionGünther Deschner2017-07-121-0/+9
| | | | | | | | | | | | | | | | | | | | | | | fruit:model = iMac fruit:model = MacBook fruit:model = MacPro fruit:model = Xserve will all display a different icon inside Finder. Formerly, we used "Samba" which resulted in a "?" icon in Finder, with the new default "MacSamba" we appear with a computer box icon at least. Guenther Bug: https://bugzilla.samba.org/show_bug.cgi?id=12840 Signed-off-by: Guenther Deschner <gd@samba.org> Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Ralph Boehme <slow@samba.org> Autobuild-User(master): Günther Deschner <gd@samba.org> Autobuild-Date(master): Wed Jul 12 03:17:57 CEST 2017 on sn-devel-144
* vfs_fruit: fix a typoRalph Boehme2017-07-101-1/+1
| | | | | | | | Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Andrew Bartlett <abartlet@samba.org> Autobuild-User(master): Ralph Böhme <slow@samba.org> Autobuild-Date(master): Mon Jul 10 16:48:24 CEST 2017 on sn-devel-144
* docs: Document new smbclient deltree command.Jeremy Allison2017-07-071-0/+10
| | | | | | Signed-off-by: Jeremy Allison <jra@samba.org> Reviewed-by: Alexander Bokovoy <ab@samba.org> Reviewed-by: Andreas Schneider <asn@samba.org>
* docs-xml: Document net tdb commandChristof Schmitt2017-05-081-0/+22
| | | | | Signed-off-by: Christof Schmitt <cs@samba.org> Reviewed-by: Volker Lendecke <vl@samba.org>
* docs: Update idmap_rid manpageAndreas Schneider2017-04-181-8/+4
| | | | | Signed-off-by: Andreas Schneider <asn@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* docs: fixup smbclient rename -f optionUri Simchoni2017-04-081-3/+3
| | | | | | | | | | | | Fixup documentation of new -f option of the smbclient rename command. This command is supported by SMB1 and SMB2. Signed-off-by: Uri Simchoni <uri@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org> Autobuild-User(master): Jeremy Allison <jra@samba.org> Autobuild-Date(master): Sat Apr 8 02:38:16 CEST 2017 on sn-devel-144
* manpages: update smbclient manpage with rename -f optionUri Simchoni2017-03-281-2/+5
| | | | | | | Document the -f option of the rename command. Signed-off-by: Uri Simchoni <uri@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* vfs_fruit: document added zero_file_id parameterUri Simchoni2017-03-261-0/+17
| | | | | | | BUG: https://bugzilla.samba.org/show_bug.cgi?id=12715 Signed-off-by: Uri Simchoni <uri@samba.org> Reviewed-by: Ralph Boehme <slow@samba.org>
* idmap_rfc2307: Clarify the documentation a bitVolker Lendecke2017-03-221-2/+2
| | | | | | | | | | "bind_path" is a variable name internally used inside Samba. If you look at "man ldapsearch" from OpenLDAP for example, the more common term for this parameter is "search base". Adapt the documentation accordingly. Signed-off-by: Volker Lendecke <vl@samba.org> Reviewed-by: Uri Simchoni <uri@samba.org>
* manpages/vfs_fruit: document global optionsRalph Boehme2017-03-081-56/+99
| | | | | | | | | Some options MUST be set in the global section, better document that. Bug: https://bugzilla.samba.org/show_bug.cgi?id=12615 Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* docs: Improve the idmap_hash manpageAndreas Schneider2017-03-031-3/+21
| | | | | | | BUG: https://bugzilla.samba.org/show_bug.cgi?id=12582 Signed-off-by: Andreas Schneider <asn@samba.org> Reviewed-by: Michael Adam <obnox@samba.org>
* vfs_fruit: drop "ea support" from the manpageUri Simchoni2017-03-021-3/+0
| | | | | | | | Now that ea support is not required, drop that comment from the man page. Signed-off-by: Uri Simchoni <uri@samba.org> Reviewed-by: Ralph Boehme <slow@samba.org>
* vfs_fruit: only veto AppleDouble files with fruit:resource=fileRalph Boehme2017-03-021-4/+8
| | | | | | | | | | | | vfs_fruit only creates AppleDouble files itself when "fruit:resource" is set to "file" (the default). It is only then the these AppleDouble files should be treated as an internal representation and should be inaccessible from clients. Bug: https://bugzilla.samba.org/show_bug.cgi?id=12526> Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Uri Simchoni <uri@samba.org>
* docs/vfs_fruit: document known limitations with fruit:encoding=nativeRalph Boehme2017-03-021-2/+6
| | | | | | | BUG: https://bugzilla.samba.org/show_bug.cgi?id=12427 Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Uri Simchoni <uri@samba.org>
* Correct "explicity" typos.Chris Lamb2017-02-221-1/+1
| | | | | | Signed-off-by: Chris Lamb <chris@chris-lamb.co.uk> Reviewed-by: Andrew Bartlett <abartlet@samba.org> Reviewed-by: Garming Sam <garming@catalyst.net.nz>
* Correct "seperate" typos.Chris Lamb2017-02-221-1/+1
| | | | | | Signed-off-by: Chris Lamb <chris@chris-lamb.co.uk> Reviewed-by: Andrew Bartlett <abartlet@samba.org> Reviewed-by: Garming Sam <garming@catalyst.net.nz>
* docs/vfs_ceph: document user_id parameterDavid Disseldorp2017-02-151-0/+14
| | | | | | | | Signed-off-by: David Disseldorp <ddiss@samba.org> Reviewed-by: Ralph Böhme <slow@samba.org> Autobuild-User(master): David Disseldorp <ddiss@samba.org> Autobuild-Date(master): Wed Feb 15 21:00:53 CET 2017 on sn-devel-144
* s3/util: mvxattr, a tool to rename extended attributesRalph Boehme2017-02-101-0/+100
| | | | | | | | | | | | | | | | | | | | | | Usage: mvxattr -s STRING -d STRING PATH [PATH ...] -s, --from=STRING xattr source name -d, --to=STRING xattr destination name -l, --follow-symlinks follow symlinks, the default is to ignore them -p, --print print files where the xattr got renamed -v, --verbose print files as they are checked -f, --force force overwriting of destination xattr Help options: -?, --help Show this help message --usage Display brief usage message Bug: https://bugzilla.samba.org/show_bug.cgi?id=12490 Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org> Autobuild-User(master): Jeremy Allison <jra@samba.org> Autobuild-Date(master): Fri Feb 10 22:24:59 CET 2017 on sn-devel-144
* docs: Improve description of "unix_primary_group" parameter in idmap_ad manpageJohn Mulligan2017-01-271-8/+19
| | | | | | | | | | | Bug: https://bugzilla.samba.org/show_bug.cgi?id=12542 Signed-off-by: John Mulligan <jmulligan@nasuni.com> Reviewed-by: Volker Lendecke <vl@samba.org> Reviewed-by: Ralph Boehme <slow@samba.org> Autobuild-User(master): Ralph Böhme <slow@samba.org> Autobuild-Date(master): Fri Jan 27 20:58:18 CET 2017 on sn-devel-144
* smbcontrol: add ringbuf-logRalph Boehme2017-01-201-0/+7
| | | | | | | | Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Volker Lendecke <vl@samba.org> Autobuild-User(master): Volker Lendecke <vl@samba.org> Autobuild-Date(master): Fri Jan 20 22:33:14 CET 2017 on sn-devel-144
* docs: Bump version up to 4.7.Karolin Seeger2017-01-1295-95/+95
| | | | | Signed-off-by: Karolin Seeger <kseeger@samba.org> Reviewed-by: Stefan Metzmacher <metze@samba.org>
* idmap_ad: Restore querying SFU nss infoVolker Lendecke2017-01-021-0/+14
| | | | | | | | | | | | | With the last commit the getpwsid call did not look at the winbind nss info parameter anymore. This restores it for the idmap ad backend with slightly different semantics and configuration: We now have the unix_primary_group and unix_nss_info domain-specific parameters for idmap config. This enables overriding the Windows primary group with the unix one. Signed-off-by: Volker Lendecke <vl@samba.org> Reviewed-by: Uri Simchoni <uri@samba.org> Reviewed-by: Andreas Schneider <asn@samba.org>
* docs-xml: Remove duplicate listing of configfile option in man pagesAnoop C S2016-12-212-2/+0
| | | | | | | | | | | | | | stdarg.configfile option is hierarchically included within common.samba.client entity. So explicit inclusion of this term will generate man pages with configfile option listed twice. Signed-off-by: Anoop C S <anoopcs@redhat.com> Reviewed-by: Guenther Deschner <gd@samba.org> Reviewed-by: David Disseldorp <ddiss@samba.org> Autobuild-User(master): Günther Deschner <gd@samba.org> Autobuild-Date(master): Wed Dec 21 13:13:16 CET 2016 on sn-devel-144
* smb.conf: add identity mapping sectionAlexander Bokovoy2016-12-131-0/+60
| | | | | | | | | | | | | | Add a generic identity mapping section that points out to the other resources in Samba documentation about idmap modules and their configuration. This should help users to discover corresponding documentation easily. Signed-off-by: Alexander Bokovoy <ab@samba.org> Reviewed-by: Andrea Schneider <asn@samba.org> Autobuild-User(master): Jeremy Allison <jra@samba.org> Autobuild-Date(master): Tue Dec 13 00:14:04 CET 2016 on sn-devel-144
* docs-xml: change http://samba.org to https://www.samba.orgBjörn Jacke2016-12-094-7/+7
| | | | | Signed-off-by: Bjoern Jacke <bj@sernet.de> Reviewed-by: Karolin Seeger <kseeger@samba.org>
* manpages/vfs_fruit: add warning to fruit:resoure=streamRalph Boehme2016-12-021-3/+6
| | | | | | | BUG: https://bugzilla.samba.org/show_bug.cgi?id=12412 Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* vfs_fruit: fix fruit:resource option spellingRalph Boehme2016-12-021-1/+7
| | | | | | | | | | | | | | | | | | | | | Fix all occurences of bad spelling of "resource" as "res*s*ource" (two s). One of the places where this was wrong was when parsing parametric options in the VFS connect() function in the module. As a result any setting of fruit:resource=something in smb.conf was silently ignored and the default ("file") was active. In Samba 4.6 we accept both the wrong and the correct spelling, in Samba 4.7 the bad spelling will be removed. BUG: https://bugzilla.samba.org/show_bug.cgi?id=12412 Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* wbinfo: Use ntlmv2 by default for wbinfo -aVolker Lendecke2016-11-151-1/+10
| | | | | Signed-off-by: Volker Lendecke <vl@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* support volfile fetch from multiple glusterd nodesRaghavendra Talur2016-10-141-2/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | glusterfs:volfile_server option can be used in smb.conf to define where to fetch the volfile from. Currently it supports only a single IP or a hostname. The default is 'localhost'. glfs_set_volfile_server() has been enhanced in gfapi to support multiple invocations. A list is maintained in libgfapi which gets appended on every invocation. When glfs_init is performed, libgfapi would first try to fetch the volfile from glusterd on that node. However, on failure to fetch the volfile, it would proceed to contact glusterd on every node in the list until it gets the volfile or exhausts the list. This enhacement was done in Gluster commit [2]. This commit is available in 3.6, 3.7, 3.8 versions of Gluster. As we cannot have multiple lines having the same key of glusterfs:volfile_server in a share definition in smb.conf, we propose a scheme like this: where value of glusterfs:volfile_server could be list of white space seperated elements where each element could be unix+/path/to/socket/file or [tcp+]IP|hostname|\[IPv6\][:port]. Note the restriction on naming a IPv6 host, it follows the same restriction that is based on IPv6 naming in URL as per RFC 2732[1]. [1] http://www.ietf.org/rfc/rfc2732.txt [2] 0c1d78f5c52c69268ec3a1d8d5fcb1a1bf15f243 Signed-off-by: Raghavendra Talur <rtalur@redhat.com> Reviewed-by: Jeremy Allison <jra@samba.org> Reviewed-by: Michael Adam <obnox@samba.org> Reviewed-by: Guenther Deschner <gd@samba.org> Autobuild-User(master): Günther Deschner <gd@samba.org> Autobuild-Date(master): Fri Oct 14 17:09:24 CEST 2016 on sn-devel-144
* smbcquotas: add -m optionUri Simchoni2016-10-041-0/+12
| | | | | | | | Add the "standard" -m command line option that controls max client protocol. Signed-off-by: Uri Simchoni <uri@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* docs/vfs_fruit: explain when to use vfs_catiaRalph Boehme2016-09-211-1/+4
| | | | | | | | Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Volker Lendecke <vl@samba.org> Autobuild-User(master): Ralph Böhme <slow@samba.org> Autobuild-Date(master): Wed Sep 21 03:54:59 CEST 2016 on sn-devel-144
* vfs_acl_xattr|tdb: enforced settings when ignore system acls=yesRalph Boehme2016-08-312-0/+30
| | | | | | | | | | | | | | | When "ignore system acls" is set to "yes, we need to ensure filesystem permission always grant access so that when doing our own access checks we don't run into situations where we grant access but the filesystem doesn't. Bug: https://bugzilla.samba.org/show_bug.cgi?id=12181 Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org> Autobuild-User(master): Ralph Böhme <slow@samba.org> Autobuild-Date(master): Wed Aug 31 18:41:20 CEST 2016 on sn-devel-144
* docs: document vfs_acl_xattr|tdb enforced settingsRalph Boehme2016-08-312-0/+18
| | | | | | | Bug: https://bugzilla.samba.org/show_bug.cgi?id=12181 Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
* vfs_acl_xattr|tdb: add option to control default ACL styleRalph Boehme2016-08-302-0/+50
| | | | | | | | | | Existing behaviour is "posix" style. Next commit will (re)add the "windows" style. This commit doesn't change behaviour in any way. Bug: https://bugzilla.samba.org/show_bug.cgi?id=12177 Signed-off-by: Ralph Boehme <slow@samba.org> Reviewed-by: Jeremy Allison <jra@samba.org>
View Lorry Controller Status