Dart

SCP Upload Contents of String to Remote File

See more SCP Examples

Demonstrates how to upload the contents of a string variable using the SCP protocol (Secure Copy Protocol over SSH). The text is uploaded to a file in specific remote directory. If the file did not already exist, it is created. If it already existed, it is overwritten. Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // This example requires the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  final ssh = CkSsh();

  // Connect to an SSH server:

  // Hostname may be an IP address or hostname:
  final hostname = 'www.some-ssh-server.com';
  final port = 22;

  try {
    ssh.connect(hostname, port);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // Wait a max of 5 seconds when reading responses..
  ssh.idleTimeoutMs = 5000;

  // Authenticate using login/password:
  try {
    ssh.authenticatePw('myLogin', 'myPassword');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // Once the SSH object is connected and authenticated, we use it
  // as the underlying transport in our SCP object.
  final scp = CkScp();

  try {
    scp.useSsh(ssh);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  final content = 'This string will be the contents of the remote file.';
  var remotePath = 'uploads/text/testUtf8.txt';

  // The utf-8 byte representation of the string will be uploaded.
  // See https://www.chilkatsoft.com/p/p_463.asp for a list of valid charsets.
  var charset = 'utf-8';

  // This uploads to the "uploads/text" directory relative to the HOME
  // directory of the SSH user account.  
  // Note: The remote target directory must already exist on the SSH server.
  try {
    scp.uploadString(remotePath, content, charset);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  remotePath = 'uploads/text/testUtf8_withBOM.txt';

  // To include the utf-8 preamble (also known as the BOM),
  // prefix the charset name with "bom:".  Any charset that can 
  // optionally include a BOM can be specified in this way.
  charset = 'bom:utf-8';

  // Uploads to a remote file that contains text in the 
  // utf-8 representation, including the BOM at the start of the file.
  try {
    scp.uploadString(remotePath, content, charset);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  print('SCP upload string success.');

  // Disconnect
  ssh.disconnect();
}