From nobody@FreeBSD.org  Wed Aug 21 15:34:38 2002
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id EC50837B400
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 21 Aug 2002 15:34:38 -0700 (PDT)
Received: from www.freebsd.org (www.FreeBSD.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 8BF2B43E77
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 21 Aug 2002 15:34:38 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.4/8.12.4) with ESMTP id g7LMYcOT032289
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 21 Aug 2002 15:34:38 -0700 (PDT)
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.4/8.12.4/Submit) id g7LMYcE9032288;
	Wed, 21 Aug 2002 15:34:38 -0700 (PDT)
Message-Id: <200208212234.g7LMYcE9032288@www.freebsd.org>
Date: Wed, 21 Aug 2002 15:34:38 -0700 (PDT)
From: Eric Anderson <anderson@centtech.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [PATCH] XFree86 section should document -nolisten tcp option in startx
X-Send-Pr-Version: www-1.0

>Number:         41865
>Category:       docs
>Synopsis:       [PATCH] XFree86 section should document -nolisten tcp option in startx
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 21 15:40:06 PDT 2002
>Closed-Date:    Tue May 13 12:20:15 PDT 2003
>Last-Modified:  Tue May 13 12:30:09 PDT 2003
>Originator:     Eric Anderson
>Release:        4.6.2-RELEASE
>Organization:
>Environment:
FreeBSD host.domain.com 4.6.2-RELEASE FreeBSD 4.6.2-RELEASE #1: Mon Aug 19 14:15:34 CDT 2002     root@host.domain.com:/usr/obj/usr/src/sys/NEW  i386
>Description:
      When installing (or upgrading) FreeBSD 4.6 or greater (versions with XFree86 4.x), the startx program has a line "-nolisten tcp" which causes things like opening X apps remotely and displaying them on your local X server to not work.
I couldn't find any docs on this, so please point it out if I just missed it.
>How-To-Repeat:
      Install/upgrade to 4.6(.2) with XFree86 installed.  Run startx to start your X server.  Log in to a remote machine, and try to run xcalc (or any X program) and have it display on your local machine.  

>Fix:
      Either comment out the 'listen_tcp="-nolisten tcp"' line in /usr/X11R6/bin/startx, or remove the -nolisten tcp.  

Here's a quick paragraph for the handbook to cover this.  I'm not sure if this is the exact page to put it on, but it might be ok. 

--- chapter.sgml        Wed Aug 21 17:13:25 2002
+++ chapter.sgml-patch  Wed Aug 21 17:24:43 2002
@@ -491,6 +491,17 @@
        <application>XFree86 4.X</application> can also be started with
        &man.xdm.1;.</para>
 
+      <para>In order for you to use remotely executed X-Windows programs
+        such as an <application>xterm</application>, you will most likely
+        need to change the <filename>/usr/X11R6/bin/startx</filename> X11
+        startup script and change the line:</para>
+
+      <programlisting>listen_tcp="-nolisten tcp"</programlisting>
+
+      <para>to:</para>
+
+      <programlisting>listen_tcp=""</programlisting>
+
     </sect2>
 
     <sect2>

>Release-Note:
>Audit-Trail:

From: Josh Paetzel <friar_josh@webwarrior.net>
To: Eric Anderson <anderson@centtech.com>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/41865: [PATCH] XFree86 section should document -nolisten
	tcp option in startx
Date: 21 Aug 2002 18:25:07 +0000

 T 2002     root@host.domain.com:/usr/obj/usr/src/sys/NEW  i386
 > >Description:
 >       When installing (or upgrading) FreeBSD 4.6 or greater (versions with XFree86 4.x), the startx program has a line "-nolisten tcp" which causes things like opening X apps remotely and displaying them on your local X server to not work.
 > I couldn't find any docs on this, so please point it out if I just missed it.
 > >How-To-Repeat:
 >       Install/upgrade to 4.6(.2) with XFree86 installed.  Run startx to start your X server.  Log in to a remote machine, and try to run xcalc (or any X program) and have it display on your local machine.  
 > 
 > >Fix:
 >       Either comment out the 'listen_tcp="-nolisten tcp"' line in /usr/X11R6/bin/startx, or remove the -nolisten tcp.  
 > 
 > Here's a quick paragraph for the handbook to cover this.  I'm not sure if this is the exact page to put it on, but it might be ok. 
 > 
 > --- chapter.sgml        Wed Aug 21 17:13:25 2002
 > +++ chapter.sgml-patch  Wed Aug 21 17:24:43 2002
 > @@ -491,6 +491,17 @@
 >         <application>XFree86 4.X</application> can also be started with
 >         &man.xdm.1;.</para>
 >  
 > +      <para>In order for you to use remotely executed X-Windows programs
 > +        such as an <application>xterm</application>, you will most likely
 > +        need to change the <filename>/usr/X11R6/bin/startx</filename> X11
 > +        startup script and change the line:</para>
 > +
 > +      <programlisting>listen_tcp="-nolisten tcp"</programlisting>
 > +
 > +      <para>to:</para>
 > +
 > +      <programlisting>listen_tcp=""</programlisting>
 > +
 >      </sect2>
 >  
 >      <sect2>
 > 
 > >Release-Note:
 > >Audit-Trail:
 > >Unformatted:
 
 #man startx
 
 NAME
        startx - initialize an X session
 
 SYNOPSIS
        startx  [ [ client ] options ... ] [ -- [ server ] options
        ... ]
 
 DESCRIPTION
        The startx script is a front end to xinit that provides  a
        somewhat nicer user interface for running a single session
        of the X Window System.  It is often  run  with  no  argu-
        ments.
 
        Except for the '-listen_tcp' option, arguments immediately
        following the startx command are used to start a client in
        the  same manner as xinit(1).  The '-listen_tcp' option of
        startx enables the TCP/IP transport type which  is  needed
        for  remote  X  displays.  This is disabled by default for
        security reasons.
 
 
 Josh
 

From: Marc Fonvieille <blackend@FreeBSD.org>
To: Eric Anderson <anderson@centtech.com>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/41865: [PATCH] XFree86 section should document -nolisten tcp option in startx
Date: Thu, 22 Aug 2002 12:15:23 +0200

 > --- chapter.sgml        Wed Aug 21 17:13:25 2002
 > +++ chapter.sgml-patch  Wed Aug 21 17:24:43 2002
 > @@ -491,6 +491,17 @@
 >         <application>XFree86 4.X</application> can also be started with
 >         &man.xdm.1;.</para>
 >  
 > +      <para>In order for you to use remotely executed X-Windows programs
 > +        such as an <application>xterm</application>, you will most likely
 > +        need to change the <filename>/usr/X11R6/bin/startx</filename> X11
 > +        startup script and change the line:</para>
 > +
 > +      <programlisting>listen_tcp="-nolisten tcp"</programlisting>
 > +
 > +      <para>to:</para>
 > +
 > +      <programlisting>listen_tcp=""</programlisting>
 > +
 
 It's not a good thing to tell people to change files installed by
 ports/packages, it will lead to problems during "desinstallation" and/or
 upgrade.
 
 That option can be given to startx on the command line as documented in
 startx(1).
 
 I don't think, it should be in the Handbook, but maybe in the FAQ, and
 also something about using "ssh -X" too would be great :)
 
 Marc

From: Eric Anderson <anderson@centtech.com>
To: Marc Fonvieille <blackend@freebsd.org>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/41865: [PATCH] XFree86 section should document -nolisten tcp option in startx
Date: Thu, 22 Aug 2002 07:38:54 -0500

 The FAQ seems like an appropriate place, and I agree with the "don't edit files 
 installed by ports/packages" for the most part.  It definitely needs to be 
 documented somewhere, since there are posts on various groups asking the 
 question, and rarely an answer.
 
 I'll try to whip up a FAQ piece for it.
 
 Eric
 
 Marc Fonvieille wrote:
 
 >>--- chapter.sgml        Wed Aug 21 17:13:25 2002
 >>+++ chapter.sgml-patch  Wed Aug 21 17:24:43 2002
 >>@@ -491,6 +491,17 @@
 >>        <application>XFree86 4.X</application> can also be started with
 >>        &man.xdm.1;.</para>
 >> 
 >>+      <para>In order for you to use remotely executed X-Windows programs
 >>+        such as an <application>xterm</application>, you will most likely
 >>+        need to change the <filename>/usr/X11R6/bin/startx</filename> X11
 >>+        startup script and change the line:</para>
 >>+
 >>+      <programlisting>listen_tcp="-nolisten tcp"</programlisting>
 >>+
 >>+      <para>to:</para>
 >>+
 >>+      <programlisting>listen_tcp=""</programlisting>
 >>+
 >>
 > 
 > It's not a good thing to tell people to change files installed by
 > ports/packages, it will lead to problems during "desinstallation" and/or
 > upgrade.
 > 
 > That option can be given to startx on the command line as documented in
 > startx(1).
 > 
 > I don't think, it should be in the Handbook, but maybe in the FAQ, and
 > also something about using "ssh -X" too would be great :)
 > 
 > Marc
 > 
 
 
 -- 
 ------------------------------------------------------------------
 Eric Anderson	   Systems Administrator      Centaur Technology
 The moon may be smaller than Earth, but it's further away.
 ------------------------------------------------------------------
 
State-Changed-From-To: open->feedback 
State-Changed-By: trhodes 
State-Changed-When: Thu Jan 23 08:21:10 PST 2003 
State-Changed-Why:  
Eric, have you `whipped up' a patch for our FAQ? 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Thu Jan 23 08:21:10 PST 2003 
Responsible-Changed-Why:  
Eric, have you `whipped up' a patch for our FAQ? 

http://www.freebsd.org/cgi/query-pr.cgi?pr=41865 

From: Eric Anderson <anderson@centtech.com>
To: freebsd-gnats-submit@FreeBSD.org, anderson@centtech.com
Cc:  
Subject: Re: docs/41865: [PATCH] XFree86 section should document -nolisten
 tcp option in startx
Date: Tue, 13 May 2003 11:11:15 -0500

 This is a multi-part message in MIME format.
 --------------070006080509050006020303
 Content-Type: text/plain; charset=us-ascii; format=flowed
 Content-Transfer-Encoding: 7bit
 
 Here's my patch for this for the FAQ.
 
 Attached..
 
 --------------070006080509050006020303
 Content-Type: text/plain;
  name="book.sgml-faq-patch"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: inline;
  filename="book.sgml-faq-patch"
 
 --- book.sgml	Thu May  8 14:58:37 2003
 +++ book.sgml-new	Tue May 13 11:08:03 2003
 @@ -7740,6 +7740,21 @@
        </qandaentry>
  
        <qandaentry>
 +        <question id="no-remote-x11">
 +          <para>Why can't I use remote X displays?</para>
 +        </question>
 +
 +        <answer>
 +          <para>For security reasons, the default setting is to not allow a 
 +            machine to remotely open a window.</para>
 +
 +          <para>To enable this, when starting X Windows, simply start it
 +            with the optional <option>-listen_tcp</optional> argument:</para>
 +            <screen>&prompt.user; <userinput>startx -listen_tcp</userinput></screen>
 +        </answer>
 +      </qandaentry>
 +
 +      <qandaentry>
          <question id="window-menu-weird">
            <para>Why do X Window menus and dialog boxes not work right?</para>
          </question>
 
 --------------070006080509050006020303--
 
State-Changed-From-To: feedback->closed 
State-Changed-By: trhodes 
State-Changed-When: Tue May 13 12:19:46 PDT 2003 
State-Changed-Why:  
Slightly different version of Eric's patch applied.  Thanks for the submission. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=41865 

From: Tom Rhodes <trhodes@FreeBSD.org>
To: Eric Anderson <anderson@centtech.com>,
	FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/41865: [PATCH] XFree86 section should document -nolisten
 tcp option in startx
Date: Tue, 13 May 2003 15:09:22 -0400

 On Tue, 13 May 2003 09:20:07 -0700 (PDT)
 Eric Anderson <anderson@centtech.com> wrote:
 
 Hi Eric,
 
 I've made the following changes to your patch and applied it:
 
 >  
 >  --- book.sgml	Thu May  8 14:58:37 2003
 >  +++ book.sgml-new	Tue May 13 11:08:03 2003
 >  @@ -7740,6 +7740,21 @@
 >         </qandaentry>
 >   
 >         <qandaentry>
 >  +        <question id="no-remote-x11">
 >  +          <para>Why can't I use remote X displays?</para>
 >  +        </question>
 
 s/Why can't I use/How do I enable/
 
 >  +
 >  +        <answer>
 >  +          <para>For security reasons, the default setting is to not allow a 
 >  +            machine to remotely open a window.</para>
 >  +
 >  +          <para>To enable this, when starting X Windows, simply start it
 
 s/To enable this, when starting X Windows, simply start it/To enable this feature,
 simply start <application>X</application>
 
 >  +            with the optional <option>-listen_tcp</optional> argument:</para>
 
 <option>-listen_tcp</optional> does not build, I changed optional to option.
 
 >  +            <screen>&prompt.user; <userinput>startx -listen_tcp</userinput></screen>
 >  +        </answer>
 >  +      </qandaentry>
 >  +
 >  +      <qandaentry>
 >           <question id="window-menu-weird">
 >             <para>Why do X Window menus and dialog boxes not work right?</para>
 >           </question>
 
 Otherwise, this was applied fine.  Thanks for your submission.
 
 --
 Tom Rhodes
>Unformatted:
