Copyright 2007 Sun Microsystems


1. Introduction
   1.1. Project/Component Working Name:

      tsclient

   1.2. Name of Document Author/Supplier:

      Halton Huo

   1.3. Date of This Document:

      06/26/08
        
           1.3.1. Date this project was conceived:

            03/26/07

   1.4. Name of Major Document Customer(s)/Consumer(s):

      1.4.1. The PAC or CPT you expect to review your project:

            Solaris PAC

      1.4.2. The ARC(s) you expect to review your project:

            LSARC

      1.4.3. The Director/VP who is "Sponsoring" this project:

            robert.odea@sun.com

      1.4.4. The name of your business unit:

            OPG / OpenSource.

   1.5. Email Aliases:

      1.5.1. Responsible Manager:

            harry.lu@sun.com

      1.5.2. Responsible Engineer:

            halton.huo@sun.com

      1.5.3. Marketing Manager:

            glynn.foster@sun.com

      1.5.4. Interest List:

            desktop-discuss@opensolaris.org

4. Technical Description:
    4.1. Details:

         tsclient (Terminal Server Client) is a frontend for rdesktop and other
         remote desktop tools. It is a GNOME application. Notable visual
         options include color depth, screen size, and motion blocking.

         Features include: 
         - a GNOME panel applet to quickly launch saved profiles
         - similar look and functionality to the Microsoft client and
           compatibility with its file format
         - support for rdesktop(1) 1.3, Xephyr and VNC clients like
           vncviewer(1)

         /usr/bin/tsclient is a GUI wrapper tool. When it starts up, user can
         choose connection protocol from a combo box. Depending on the protocol
         chosen, it will call the relevant programs and with corresponding
         parameters.
         - RDP (connect to Microsoft Windows 2000 and older systems)
           command is like "rdesktop -4 <hostname>"
         - RDP v5 (connect to Microsoft Windows XP and newer systems)
           command is like "rdesktop <hostname>"
           There is no "-5" here because it is default for rdesktop(1)
         - VNC (connect to systems sharing the desktop by using VNC)
           command is like "vncviewer <hostname>"
         - XDMCP (connect to servers running X)
           command is like "Xephyr :1 -once -query <hostname>"
         - ICA (connect to Citrix servers)
           This will call command "wfica", which is not available on Solaris.
           command is like "wfica -description <hostname>" 
        
         This proposal adds version 0.150, the latest stable release.

         The tsclient program supports the following options:
         Usage: tsclient [OPTION]... [FILE]...
         FILE           an rdp format file containing options
         -h, --help     display this help and exit
         -v, --version  output version information and exit
         -x FILE        launch rdesktop with options specified in FILE

         /usr/lib/tsclient-applet is a GNOME panel applet, is aim to 
         launch saved profiles.


    4.2. Bug/RFE Number(s):

      None.

    4.3. In Scope:

      See above.

    4.4. Out of Scope:

      See above.

    4.5. Interfaces:
       
                                   Exported  Interface 

        Interface Name                                        Classification     Comment
        -------------------                                   ---------------    --------------       
        SUNWtsclient                                          Uncommitted        Package name
        /usr/bin/tsclient                                     Volatile           tsclient GUI
        /usr/lib/tsclient-applet                              Volatile           GNOME panel applet
        /usr/share/applications/tsclient.desktop              Volatile           UI spec
        /usr/share/mime-info/tsclient.keys                    Volatile           mime info
        /usr/share/mime-info/tsclient.mime                    Volatile           mime info
        /usr/share/application-registry/tsclient.applications Volatile           mime type handler
        /usr/lib/bonobo/servers/GNOME_TSClientApplet.server   Volatile           bonobo server file
        /usr/share/man/man1/tsclient.1                        Volatile           Manpage
        /usr/share/pixmaps/tsclient                           Project Private    Directory
        /usr/share/pixmaps/tsclient.png                       Project Private    icon 

                                    Imported  Interface 

        Interface       Classification          ARC case                Comment
        --------        ---------------         ----------              ------------------
        rdesktop        Volatile                LSARC 2008/083          rdp CLI tool
        vncviewer       Volatile                LSARC 2007/625          vnc CLI client tool
        Xephyr          Volatile                PSARC 2007/051          Xephyr CLI tool
        GNOME Libraries Committed               LSARC 2005/734          

              
    4.6. Doc Impact:

           New manpage, tsclient.1.

    4.7. Admin/Config Impact:

      This tool might be used by Administrators, who want to control their
      machines with Remote Desktop enabled.

    4.8. HA Impact:

      None.

    4.9. I18N/L10N Impact:

      The JDS team and the G11N are working together to evaluate and
      provide I18N/L10N support.

    4.10. Packaging & Delivery:

      Adds new package, SUNWtsclient, approx 458 KB.
      Package will only go into SUNWCall and SUNWCXall clusters.

    4.11. Security Impact:

      tsclient is a wrapper tool for rdesktop, vncviewer, Xephyr, itself
      does not have any security issue. 

    4.12. Dependencies:

      The following versions of the imported interfaces are required:
         rdesktop
         vncviewer
         Xephyr
      They are optional dependencies, without them, tsclient can run, but 
      without releated feature.
      

5. Reference Documents:

      [1] tsclient homepage: 
          http://sourceforge.net/projects/tsclient

      [2] Related ARC Cases:
          LSARC 2008/083: rdesktop
          LSARC 2007/625: vncviewer
          PSARC 2007/051: xorg server upgrade to 7.2 
          LSARC 2005/734: GNOME For Nevada