From sacadmin Tue Jan 16 09:26:31 2007 Received: from sac.sfbay.sun.com (localhost [127.0.0.1]) by sac.sfbay.sun.com (8.13.6+Sun/8.13.6) with ESMTP id l0GHQVwT004316; Tue, 16 Jan 2007 09:26:31 -0800 (PST) Received: (from darrenm@localhost) by sac.sfbay.sun.com (8.13.6+Sun/8.13.6/Submit) id l0GHQVQg004312; Tue, 16 Jan 2007 09:26:31 -0800 (PST) Date: Tue, 16 Jan 2007 09:26:31 -0800 (PST) From: Darren J Moffat Message-Id: <200701161726.l0GHQVQg004312@sac.sfbay.sun.com> To: PSARC@sac.sfbay.sun.com Cc: ssh-iteam@sun.com Subject: sftp resync with OpenSSH [PSARC/2007/033 Timeout: 01/23/2007] Status: RO Content-Length: 9502 Template Version: @(#)onepager.txt 1.30 06/09/28 SMI 1. Introduction 1.1. Project/Component Working Name: Resync sftp from OpenSSH to SUNWssh 1.2. Name of Document Author/Supplier: Jan Pechanec 1.3. Date of This Document: 01/05/07 1.4. Name of Major Document Customer(s)/Consumer(s): 1.4.2. The ARC(s) you expect to review your project: PSARC 1.4.4. The name of your business unit: Security 1.5. Email Aliases: 1.5.1. Responsible Manager: Craig.Payne@Sun.COM 1.5.2. Responsible Engineer: Jan.Pechanec@Sun.COM 1.5.3. Marketing Manager: Mark.Thacker@Sun.COM 1.5.4. Interest List: ssh-iteam@Sun.COM 2. Project Summary 2.1. Project Description: Resync sftp/sftp-server from OpenSSH to SUNWssh. Since the time SUNWssh forked from OpenSSH there were quite a few changes (see below in 4.5) that made OpenSSH's sftp easier to use for users. We should resync those features. User visible changes are described in 4.5. We will also incorporate all small fixes and cleanups that were integrated to OpenSSH since the last resync (like killing forked ssh(1) on receipt of signals TERM and HUP and allowing to use embedded '@' in user names like user@vhost@realhost). 2.2. Risks and Assumptions: None. 3. Business Summary 3.1. Problem Area: sftp is not as easy to use as it could be. 3.3. Business Justification: People are comparing SUNWssh to OpenSSH and often find missing features in SUNWssh that are found in OpenSSH. One of those are some of new sftp(1) features that were added there after SUNWsun forked from OpenSSH. 4. Technical Description: 4.1. Details: I will resync with latest OpenSSH (4.5 now). It's an external code with existing open source review. 4.2. Bug/RFE Number(s): 6481668 sftp(1) needs a resync with OpenSSH 6425816 sftp: should exit with nonzero status on batch command errors 4.5. Interfaces: We do not add any new command line options We do not add any new configuration file keywords. We change/add behaviour of/to: - will handle SIGINT gracefully during commands; it will now interrupt the internal command (eg. uploading or downloading), not killing the sftp process as before - support more flags for remote ls (-1aflnrSt) - multicolumn remote ls output by default - '-' used instead of filename with batch mode reads from stdin - we add ability to suppress abort on error in batchmode (example: "-put non-existent-file") - '#' is a comment (useful in batch files) We also add a progressmeter that was missing. 4.6. Doc Impact: Manual page for sftp(1) will be updated. Diff follows: --- sftp.0 Fri Jan 5 14:33:09 2007 +++ sftp.0.new Fri Jan 5 15:29:19 2007 @@ -1,20 +1,23 @@ User Commands sftp(1) NAME sftp - secure file transfer program SYNOPSIS - sftp [options] [user@]host[:dir[/]] + sftp [-1Cv] [-B buffer_size] [-b batchfile] [-F ssh_config] + [-o ssh_option] [-P sftp_server_path] [-R num_requests] [-S program] + [-s subsystem | sftp_server] host + sftp [[user@]host[:file [file]]] + sftp [[user@]host[:dir[/]]] + sftp -b batchfile [user@]host - sftp [options] [user@]host[:file1 [file1 [file | dir2]] - DESCRIPTION The sftp utility is an interactive file transfer program with a user interface similar to ftp(1) that uses the ssh(1) command to create a secure connection to the server. sftp implements the SSH File Transfer Protocol as defined in IETF draft-ietf-secsh-filexfer. There is no relationship between the protocol used by sftp and the FTP protocol (RFC959) provided by ftp(1). @@ -39,24 +42,32 @@ -b batchfile Batch mode reads a series of commands from an input batchfile SunOS 5.11 Last change: 15 Sep 2004 1 User Commands sftp(1) instead of stdin. Since it lacks user interaction, it should be used in conjunction with non- - interactive authentication. sftp + interactive authentication. A + batchfile of `-' may be used to + indicate standard input. sftp aborts if any of the following - commands fail: get, rm, and - lmkdir. + commands fail: get, put, rm, + rename, ln, rm, mkdir, chdir, ls, + lchdir, chmod, chown, chgrp, lpwd + and lmkdir. Termination on error + can be suppressed on a command by + command basis by prefixing the + command with a `-' character (for + example, -rm /tmp/blah*). -B buffer_size Specifies the size of the buffer that sftp uses when transferring files. Larger buffers require fewer round trips at the cost of higher memory consumption. The default is 32768 bytes. -C Enables compression, using the -C flag in ssh(1). @@ -86,21 +97,23 @@ be outstanding at any one time. Increasing this can slightly improve file transfer speed but increases memory usage. The default is 16 outstanding requests. -S ssh program path Uses the given program instead of ssh(1) to connect to the sftp server. The -P and -S options - are mutually exclusive. + are mutually exclusive. The + program must understand ssh(1) + options. -s subsystem | sftp_server Specifies the SSH2 subsystem or the path for an sftp server on the remote host. A path is use- ful for using sftp over protocol version 1, or when the remote sshd does not have an sftp sub- system configured. -v Raises logging level. This @@ -174,29 +187,54 @@ Creates local directory specified by path. ln oldpath newpath Creates a link from oldpath to newpath. lpwd Prints local working directory. - ls [flags] [path] + ls [-1aflnrSt] [path] + SunOS 5.11 Last change: 15 Sep 2004 5 User Commands sftp(1) Displays remote directory listing of either path or - current directory if path is not specified. + current directory if path is not specified. path may + contain wildcards. + The following flags are recognized and alter the behaviour of ls + accordingly: + + -1 Produce single columnar output. + + -a List files beginning with a dot (`.'). + + -f Do not sort the listing. The default sort order is lexi- + cographical. + + -l Display additional details including permissions and own- + ership information. + + -n Produce a long listing with user and group information + presented numerically. + + -r Reverse the sort order of the listing. + + -S Sort the listing by file size. + + -t Sort the listing by last modification time. + + lumask umask Sets local umask to umask. mkdir path Creates remote directory specified by path. put [flags] local-path [local-path] @@ -231,20 +269,24 @@ Removes remote directory specified by path. rm path Deletes remote file specified by path. symlink oldpath newpath Creates a symbolic link from oldpath to newpath. + # [comment] + + Include a comment (useful in batchfiles). + ! command Executes command in local shell. ! Escapes to local shell. SunOS 5.11 Last change: 15 Sep 2004 7 4.7. Admin/Config Impact: None. 4.9. I18N/L10N Impact: None. 4.10. Packaging & Delivery: SUNWsshu, SUNWsshdu 4.11. Security Impact: N/A 4.12. Dependencies: N/A 5. Reference Documents: N/A 6. Resources and Schedule: 6.1. Projected Availability: project inception and integration: 1-2Q 2007 6.5. ARC review type: FastTrack From sacadmin Tue Jan 16 14:18:28 2007 Received: from sfbaymail2sca.sfbay.sun.com (sfbaymail2sca.SFBay.Sun.COM [129.145.155.42]) by sac.sfbay.sun.com (8.13.6+Sun/8.13.6) with ESMTP id l0GMIRfJ015441; Tue, 16 Jan 2007 14:18:27 -0800 (PST) Received: from gmp-ea-fw-1.sun.com (gmpes-gis-mail-2.UK.Sun.COM [129.156.42.6]) by sfbaymail2sca.sfbay.sun.com (8.13.6+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id l0GMIQJ8018059; Tue, 16 Jan 2007 14:18:27 -0800 (PST) Received: from d1-emea-10.sun.com ([192.18.2.120]) by gmp-ea-fw-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id l0GMILkw012830; Tue, 16 Jan 2007 22:18:21 GMT Received: from conversion-daemon.d1-emea-10.sun.com by d1-emea-10.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0JBZ00201EZ1E200@d1-emea-10.sun.com> (original mail from Mark.Phalan@Sun.COM); Tue, 16 Jan 2007 22:18:21 +0000 (GMT) Received: from [192.168.1.34] ([193.85.70.14]) by d1-emea-10.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0JBZ003VMFAILEGN@d1-emea-10.sun.com>; Tue, 16 Jan 2007 22:18:21 +0000 (GMT) Date: Tue, 16 Jan 2007 23:15:30 +0100 From: Mark Phalan Subject: Re: sftp resync with OpenSSH [PSARC/2007/033 Timeout: 01/23/2007] In-reply-to: <200701161726.l0GHQVQg004312@sac.sfbay.sun.com> Sender: Mark.Phalan@Sun.COM To: Darren J Moffat Cc: PSARC@sac.sfbay.sun.com, ssh-iteam@Sun.COM Message-id: <1168985730.777.14.camel@localhost> MIME-version: 1.0 X-Mailer: Evolution 2.8.1.1 Content-type: text/plain Content-transfer-encoding: 7BIT References: <200701161726.l0GHQVQg004312@sac.sfbay.sun.com> Status: RO Content-Length: 1860 On Tue, 2007-01-16 at 09:26 -0800, Darren J Moffat wrote: > Template Version: @(#)onepager.txt 1.30 06/09/28 SMI > > 1. Introduction > 1.1. Project/Component Working Name: > > Resync sftp from OpenSSH to SUNWssh > > 1.2. Name of Document Author/Supplier: > > Jan Pechanec > > 1.3. Date of This Document: > > 01/05/07 > > 1.4. Name of Major Document Customer(s)/Consumer(s): > > 1.4.2. The ARC(s) you expect to review your project: > > PSARC > > 1.4.4. The name of your business unit: > > Security > > 1.5. Email Aliases: > 1.5.1. Responsible Manager: Craig.Payne@Sun.COM > 1.5.2. Responsible Engineer: Jan.Pechanec@Sun.COM > 1.5.3. Marketing Manager: Mark.Thacker@Sun.COM > 1.5.4. Interest List: ssh-iteam@Sun.COM > > > 2. Project Summary > 2.1. Project Description: > > Resync sftp/sftp-server from OpenSSH to SUNWssh. Since the time > SUNWssh forked from OpenSSH there were quite a few changes (see below > in 4.5) that made OpenSSH's sftp easier to use for users. We should > resync those features. > > User visible changes are described in 4.5. We will also incorporate > all small fixes and cleanups that were integrated to OpenSSH since the > last resync (like killing forked ssh(1) on receipt of signals TERM and > HUP and allowing to use embedded '@' in user names like > user@vhost@realhost). > > 2.2. Risks and Assumptions: > > None. > > > 3. Business Summary > 3.1. Problem Area: > > sftp is not as easy to use as it could be. > > 3.3. Business Justification: > > People are comparing SUNWssh to OpenSSH and often find missing > features in SUNWssh that are found in OpenSSH. One of those are some > of new sftp(1) features that were added there after SUNWsun forked ^^^^^^^^ - Mark From sacadmin Wed Jan 31 09:35:24 2007 Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234]) by sac.sfbay.sun.com (8.13.6+Sun/8.13.6) with ESMTP id l0VHZO6n020513 for ; Wed, 31 Jan 2007 09:35:24 -0800 (PST) Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6]) by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id l0VHZJ3x012775; Wed, 31 Jan 2007 09:35:20 -0800 (PST) Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) id <0JCQ00H0VU6UFL00@nwk-avmta-2.sfbay.sun.com>; Wed, 31 Jan 2007 09:35:18 -0800 (PST) Received: from nwk-ea-fw-1.sun.com ([10.4.134.6]) by nwk-avmta-2.sfbay.sun.com (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005)) with ESMTP id <0JCQ00CJAU6TD0D0@nwk-avmta-2.sfbay.sun.com>; Wed, 31 Jan 2007 09:35:17 -0800 (PST) Received: from d1-sfbay-09.sun.com ([192.18.39.119]) by nwk-ea-fw-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id l0VHZHdT019399; Wed, 31 Jan 2007 09:35:17 -0800 (PST) Received: from conversion-daemon.d1-sfbay-09.sun.com by d1-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) id <0JCQ00D01U4XON00@d1-sfbay-09.sun.com> (original mail from Sherri.Shieh@Sun.COM); Wed, 31 Jan 2007 09:35:17 -0800 (PST) Received: from [129.145.154.108] by d1-sfbay-09.sun.com (Sun Java System Messaging Server 6.2-6.01 (built Apr 3 2006)) with ESMTPSA id <0JCQ00M7PU6SBKO0@d1-sfbay-09.sun.com>; Wed, 31 Jan 2007 09:35:16 -0800 (PST) Date: Wed, 31 Jan 2007 09:35:15 -0800 From: Sherri Shieh Subject: PSARC Fast Track: sftp resync with OpenSSH (2007/033) Sender: Sherri.Shieh@sun.com To: psarc@sun.com, Darren Moffat , Jan.Pechanec@sun.com Cc: ssh-iteam@sun.com Message-id: <45C0D353.3070208@Sun.COM> MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=us-ascii Content-transfer-encoding: 7BIT X-Accept-Language: en-us, en X-PMX-Version: 5.2.0.264296 User-Agent: Mozilla/5.0 (X11; U; SunOS sun4v; en-US; rv:1.7) Gecko/20060120 Status: RO Content-Length: 341 This case has been marked closed approved based on last week's meeting. - Sherri -- ========================================================= Sherri Shieh Sun Microsystems, Inc. Program Manager Email: sherri.shieh@sun.com Systems Architecture Phone: 650-786-5245/x85245 ===========================================================