Attachment 16181 Details for Bug 14318 – patch from master for v4.13 and v4.12

[patch] patch from master for v4.13 and v4.12

patch-v4-13-test (text/plain), 6.24 KB, created by Guenther Deschner on 2020-08-21 09:32:27 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Guenther Deschner

Created: 2020-08-21 09:32:27 UTC

Size: 6.24 KB

patch

obsolete

>From dfe9d5a48ded438d2d756b48f907bddb119464f6 Mon Sep 17 00:00:00 2001
>From: =?UTF-8?q?G=C3=BCnther=20Deschner?= <gd@samba.org>
>Date: Tue, 10 Mar 2020 18:18:10 +0100
>Subject: [PATCH] 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
>
>(cherry picked from commit a9b6a8378e5db19d5d5ecd42f08ec3abd49ad5b8)
>---
> docs-xml/manpages/winexe.1.xml | 184 +++++++++++++++++++++++++++++++++
> docs-xml/wscript_build         |   5 +
> 2 files changed, 189 insertions(+)
> create mode 100644 docs-xml/manpages/winexe.1.xml
>
>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)
>-- 
>2.26.2
>

Flags:

vl: review+
gd: ci-passed+

Actions: View

Attachments on bug 14318: 16181 | 16277