diff options
author | Günther Deschner <gd@samba.org> | 2020-03-10 18:18:10 +0100 |
---|---|---|
committer | Volker Lendecke <vl@samba.org> | 2020-08-20 12:55:23 +0000 |
commit | a9b6a8378e5db19d5d5ecd42f08ec3abd49ad5b8 (patch) | |
tree | aff84d06e3acb1320f3c01521691161fd5ad1a47 /docs-xml | |
parent | 7e3ceaec449a06e9646f5543a617b3b866a720aa (diff) | |
download | samba-a9b6a8378e5db19d5d5ecd42f08ec3abd49ad5b8.tar.gz |
docs: Add missing winexe manpage
BUG: https://bugzilla.samba.org/show_bug.cgi?id=14318
Guenther
Signed-off-by: Guenther Deschner <gd@samba.org>
Reviewed-by: Volker Lendecke <vl@samba.org>
Autobuild-User(master): Volker Lendecke <vl@samba.org>
Autobuild-Date(master): Thu Aug 20 12:55:23 UTC 2020 on sn-devel-184
Diffstat (limited to 'docs-xml')
-rw-r--r-- | docs-xml/manpages/winexe.1.xml | 184 | ||||
-rw-r--r-- | docs-xml/wscript_build | 5 |
2 files changed, 189 insertions, 0 deletions
diff --git a/docs-xml/manpages/winexe.1.xml b/docs-xml/manpages/winexe.1.xml new file mode 100644 index 00000000000..c0e41c26b15 --- /dev/null +++ b/docs-xml/manpages/winexe.1.xml @@ -0,0 +1,184 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc"> +<refentry id="winexe.1"> + +<refmeta> + <refentrytitle>winexe</refentrytitle> + <manvolnum>1</manvolnum> + <refmiscinfo class="source">Samba</refmiscinfo> + <refmiscinfo class="manual">User Commands</refmiscinfo> + <refmiscinfo class="version">&doc.version;</refmiscinfo> +</refmeta> + + +<refnamediv> + <refname>winexe</refname> + <refpurpose>Winexe is a Remote Windows-command executor</refpurpose> +</refnamediv> + +<refsynopsisdiv> + <cmdsynopsis> + <command>winexe</command> + <arg choice="opt">-h</arg> + <arg choice="opt">-V</arg> + <arg choice="opt">-U [DOMAIN/]USERNAME[%PASSWORD]</arg> + <arg choice="opt">-A FILE</arg> + <arg choice="opt">-N</arg> + <arg choice="opt">-k</arg> + <arg choice="opt">-d DEBUGLEVEL</arg> + <arg choice="opt">--uninstall</arg> + <arg choice="opt">--reinstall</arg> + <arg choice="opt">--runas [DOMAIN/]USERNAME[%PASSWORD]</arg> + <arg choice="opt">--runas-file FILE</arg> + <arg choice="opt">--interactive [0|1]</arg> + <arg choice="opt">--ostype [0|1]</arg> + </cmdsynopsis> +</refsynopsisdiv> + +<refsect1> + <title>DESCRIPTION</title> + + <para>This tool is part of the <citerefentry><refentrytitle>samba</refentrytitle> + <manvolnum>7</manvolnum></citerefentry> suite.</para> + + <para>The <command>winexe</command> allows remote command execution on native + Windows operating systems.</para> +</refsect1> + +<refsect1> + <title>OPTIONS</title> + + <variablelist> + + &stdarg.help; + &stdarg.version; + &stdarg.username; + &stdarg.authfile; + &stdarg.nopass; + &stdarg.kerberos; + &stdarg.client.debug; + + <varlistentry> + <term>--uninstall</term> + <listitem> + <para> + Uninstall winexe service after remote execution. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>--reinstall</term> + <listitem> + <para> + Reinstall winexe service before remote execution. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>--runas <replaceable>[DOMAIN/]USERNAME[%PASSWORD]]</replaceable></term> + <listitem> + <para> + Run as the given user (BEWARE: this password is sent in cleartext over the network!) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>--runas-file <replaceable>FILE</replaceable></term> + <listitem> + <para> + Run as user options defined in a file. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>--interactive <replaceable>[0|1]</replaceable></term> + <listitem> + <para> + Desktop interaction. + </para> + + <para>There are two options:</para> + <itemizedlist> + <listitem> + <para> + 0 - disallow + </para> + </listitem> + + <listitem> + <para> + 1 - allow. If allow, also use the --system switch (Windows requirement). Vista does not support this optoin. + </para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + <varlistentry> + <term>--ostype <replaceable>[0|1|2]</replaceable></term> + <listitem> + <para> + Determines which version (32-bit or 64-bit) of service will be installed. + </para> + + <para>There are three options:</para> + <itemizedlist> + <listitem> + <para> + 0 - 32-bit + </para> + </listitem> + + <listitem> + <para> + 1 - 64-bit + </para> + </listitem> + + <listitem> + <para> + 2 - winexe will decide + </para> + </listitem> + </itemizedlist> + </listitem> + </varlistentry> + + </variablelist> +</refsect1> + + +<refsect1> + <title>EXIT STATUS</title> + + <para>The winexe program returns 0 if the operation + succeeded, or 1 if the operation failed. </para> +</refsect1> + + +<refsect1> + <title>VERSION</title> + + <para>This man page is part of version &doc.version; of + the Samba suite.</para> +</refsect1> + +<refsect1> + <title>AUTHOR</title> + + <para>The original Samba software and related utilities + were created by Andrew Tridgell. Samba is now developed + by the Samba Team as an Open Source project similar + to the way the Linux kernel is developed.</para> + + <para>The <command>winexe</command> and it's native Windows counterpart were written by Andrzej Hajda. + The Samba client tool winexe was later rewritten by Volker Lendecke.</para> + + <para>This manpage was written by Guenther Deschner.</para> +</refsect1> + +</refentry> diff --git a/docs-xml/wscript_build b/docs-xml/wscript_build index c7684088989..dc5f31459e7 100644 --- a/docs-xml/wscript_build +++ b/docs-xml/wscript_build @@ -64,6 +64,8 @@ pam_winbind_manpages = ''' krb5_locator_manpages = 'manpages/winbind_krb5_locator.8' krb5_localauth_manpages = 'manpages/winbind_krb5_localauth.8' +winexe_manpages = 'manpages/winexe.1' + vfs_module_manpages = ['vfs_acl_tdb', 'vfs_acl_xattr', 'vfs_aio_fork', @@ -170,6 +172,9 @@ if ('XSLTPROC_MANPAGES' in bld.env and bld.env['XSLTPROC_MANPAGES']): if bld.CONFIG_SET('HAVE_KRB5_LOCALAUTH_PLUGIN_H'): bld.SAMBAMANPAGES(krb5_localauth_manpages) + if conf.env.build_winexe == True: + bld.SAMBAMANPAGES(winexe_manpages) + for manpage in vfs_module_manpages: if bld.SAMBA3_IS_ENABLED_MODULE(manpage): bld.SAMBAMANPAGES('manpages/%s.8' % manpage) |