Objective-C

Close the SSH Tunnel

Demonstrates the Chilkat MailMan.SshCloseTunnel method, which closes the SSH tunnel used for SMTP or POP3 communication. This example opens and authenticates a tunnel, performs a mail operation through it, and then closes it.

Background: An SSH tunnel holds an open connection to the SSH server for as long as it is needed, so closing it releases both that connection and the resources on the SSH server. The natural pattern is open → authenticate → do mail work → close. It is the counterpart to SshOpenTunnel, and is separate from closing the mail connections themselves (CloseSmtpConnection / Pop3EndSession), which ride inside the tunnel.

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

#import <CkoMailMan.h>

BOOL success = NO;

//  Demonstrates the MailMan.SshCloseTunnel method, which closes the SSH tunnel used for SMTP
//  or POP3 communication.

CkoMailMan *mailman = [[CkoMailMan alloc] init];

//  Configure the POP3 server connection.
mailman.MailHost = @"pop.example.com";
mailman.MailPort = [NSNumber numberWithInt:995];
mailman.PopSsl = YES;
mailman.PopUsername = @"user@example.com";
mailman.PopPassword = @"myPassword";

//  Open and authenticate the SSH tunnel.
success = [mailman SshOpenTunnel: @"ssh.example.com" sshPort: [NSNumber numberWithInt: 22]];
if (success == NO) {
    NSLog(@"%@",mailman.LastErrorText);
    return;
}

success = [mailman SshAuthenticatePw: @"sshUser" sshPassword: @"sshPassword"];
if (success == NO) {
    NSLog(@"%@",mailman.LastErrorText);
    return;
}

//  ... perform mail operations through the tunnel ...
int count = [[mailman GetMailboxCount] intValue];
if (count < 0) {
    NSLog(@"%@",@"Failed to get the mailbox count.");
}
else {
    NSLog(@"%@%d",@"Mailbox count: ",count);
}

//  Close the SSH tunnel when finished with it.
success = [mailman SshCloseTunnel];
if (success == NO) {
    NSLog(@"%@",mailman.LastErrorText);
    return;
}

NSLog(@"%@",@"SSH tunnel closed.");