User's Guide
Reference Manual
Release Notes
PDF
Top

cosFileTransfer
Reference Manual
Version 1.2

Expand All
Contract All

Table of Contents

- cosFileTransferApp
  - Top of manual page
  - install/0
  - uninstall/0
  - start/0
  - stop/0
  - create_VFS/4
  - ssl_server_certfile/0
  - ssl_client_certfile/0
  - ssl_server_verify/0
  - ssl_client_verify/0
  - ssl_server_depth/0
  - ssl_client_depth/0
- CosFileTransfer_File
  - Top of manual page
  - '_get_name'/1
  - '_get_complete_file_name'/1
  - '_get_parent'/1
  - '_get_associated_session'/1
- CosFileTransfer_Directory
  - Top of manual page
  - list/2
- CosFileTransfer_FileIterator
  - Top of manual page
  - next_one/1
  - next_n/2
  - destroy/1
- CosFileTransfer_VirtualFileSystem
  - Top of manual page
  - '_get_file_system_type'/1
  - '_get_supported_content_types'/1
  - login/4
- CosFileTransfer_FileTransferSession
  - Top of manual page
  - '_get_protocols_supported'/1
  - set_directory/2
  - create_file/2
  - create_directory/2
  - get_file/2
  - delete/2
  - transfer/3
  - append/3
  - insert/4
  - logout/1

# cosFileTransferApp

### MODULE

cosFileTransferApp

### MODULE SUMMARY

The main module of the cosFileTransfer application.

### DESCRIPTION

To get access to the record definitions for the structures use:
-include_lib("cosFileTransfer/include/*.hrl").

This module contains the functions for starting and stopping the application.

### EXPORTS

install() -> Return

Types:

Return = ok | {'EXIT', Reason}

This operation installs the cosFileTransfer application. Note, the cosProperty application must be installed prior to invoking this operation.

uninstall() -> Return

Types:

Return = ok | {'EXIT', Reason}

This operation uninstalls the cosFileTransfer application.

start() -> Return

Types:

Return = ok | {error, Reason}

This operation starts the cosFileTransfer application.

stop() -> Return

Types:

Return = ok | {error, Reason}

This operation stops the cosFileTransfer application.

create_VFS(Type, Content, Host, Port [,Options]) -> Return

Types:

Type = 'FTP' | {'NATIVE', 'cosFileTransferNATIVE_file'} | {'NATIVE', MyModule}
Content = []
Host = string(), e.g. "myHost@myServer" or "012.345.678.910"
Port = integer()
Options = [Option]
Option = {protocol, Protocol} | {connect_timeout, Seconds}
Protocol = tcp | ssl
Return = VFS | {'EXCEPTION, E}
VFS = #objref

This operation creates a new instance of a Virtual File System. The Type parameter determines which type we want the VFS to represent. 'FTP' maps to the INETS ftp implementation, while {'NATIVE', 'cosFileTransferNATIVE_file'} uses the file module. It is also possible to implement own mappings which are activated by supplying {'NATIVE', MyModule}. The MyModule module must export the same functions and behave in the same way as the INETS ftp module, and an operation named open(Host, Port), which shall return {ok, Pid} or {error, Reason}.

If no Options are supplied the default setting will be used, i.e., tcp and 60 seconds.

The Content parameter is currently ignored by must be supplied as an empty list.

ssl_server_certfile() -> string()

This function returns a path to a file containing a chain of PEM encoded certificates for the cosFileTransfer as target. This is configured by setting the application variable ssl_server_certfile.

ssl_client_certfile() -> string()

This function returns a path to a file containing a chain of PEM encoded certificates used in outgoing calls. The default value is configured by setting the application variable ssl_client_certfile.

ssl_server_verify() -> 0 | 1 | 2

This function returns the type of verification used by SSL during authentication of the other peer for incoming calls. It is configured by setting the application variable ssl_server_verify.

ssl_client_verify() -> 0 | 1 | 2

This function returns the type of verification used by SSL during authentication of the other peer for outgoing calls. The default value is configured by setting the application variable ssl_client_verify.

ssl_server_depth() -> int()

This function returns the SSL verification depth for incoming calls. It is configured by setting the application variable ssl_server_depth.

ssl_client_depth() -> int()

This function returns the SSL verification depth for outgoing calls. The default value is configured by setting the application variable ssl_client_depth.