HS FTP Library v1.2.0 (static C library and DLL interface,C,C++,Visual Basic)

Products

▪ Network Protocol Libraries
▪ Communications Libraries
▪ Communications Software
▪ Security and Encryption
▪ Show all products

Services

▪ Software Development
▪ Web Design
▪ Area of Expertise
▪ Recent Projects

About Us

▪ Company Profile
▪ Customer List
▪ Partners
▪ Become our partner
▪ Press Releases
▪ Contact Us

Useful Information

▪ Industry Links

Download Programming Manuals

Download Evaluation Version

Related Product - HsFtpWm (Windows Mobile)

HS FTP Library v1.2.0

ORDERING AND PRICING:

ORDER NOW

Other payment methods:
Contacts Us

Features

FTP Client RFC 959 operation
Server name resolution
Concurrent FTP client sessions
Passive mode, firewall friendly
User / password authentication
Asynchronous Operation
Supported FTP Commands: USER, PASS, PASV, LIST, TYPE, RETR, STOR, CWD, MKD, RMD, DELE, NOOP, PWD, RNFR, RNTO
Recursive Folder Download
Recursive Folder Upload
Recursive Folder Delete
Configurable Timeout
Transmit and Receive Statistics

what is included in delivery?

STANDARD EDITON:

HS FTP C Library binaries and header files
HS FTP DLL Library binaries and header files
HS FTP Demo Applications binaries, C source code, project workspace
HS FTP User Manuals which document in detail complete library API

BLUEPRINT EDITON:
Everything in standard edition, plus
HS FTP full source code in C with Visual C workspace and project files

HOW IS PRODUCT delivered?

After we receive your payment, we will email you a download link to all product deliverables (Please be sure to supply correct email address on payment form)

HS FTP module file structure

Filename	Description
hsftp_if.h	Main API interface definitions
hsftp.h	Private header file
hsftp.c	Main API functions
hsftpfsm.c	FTP engine / State Machines
hsftpfsm.h	FSM submodule definitions
hsftputil.c	Utility functions support code
hsftputil.h	Utility submodule definitions

HS SOCK module structure

Filename	Description
hssock.c	Main API and core code
hssock.h	Private header file
hssock_if.h	Main API interface definitions

Hillstone Software provides additional services for customization, porting and integration of the library code to better suit the needs of your products

overview: HS FTP is a software library written in C which implements the client side of the File Transfer Protocol over TCP socket layer according to RFC 959. HS FTP is offered in two versions:

Standard Edition (source code is not included): includes Static C Library and standard DLL library, which can be used from various programming languages (Microsoft and Borland C/C++, Visual Basic, etc)

Blueprint Edition: includes all of Standard Edition plus full source code in C.

The library allows a user application to connect to remote FTP servers, traverse server directory structure, send, receive, delete and rename files, create, remove and rename folders. The HS FTP protocol module supports passive mode data connections, user / password authentication and many FTP commands sequences:
USER, PASS, TYPE, PASV, LIST, CWD, MKD, RMD, RETR, STOR, DELE, NOOP, PWD, RNFR, RNTO

HS FTP also supports recursive download, upload and delete of folder with all files and sub-folders. There are functions for configuration and statistics.

Download HsFtpDemo.c Download HS FTP interface header file - hsftp_if.h

how it works

To connect to remote FTP server, the user application calls HsFtpCliConnect function, supplying connection parameters, such as remote FTP server name or IP address, username and password for authentication etc. It also supplies a pointer to callback function that the HS FTP module uses to communicate with the user code.

When the control FTP connection is established and HS FTP has successfully passed user / password FTP account authentication phase, the user application is asynchronously notified via user event callback function with HS_FTPCLI_USR_EV_LOGGEDIN event.

At this point, the user application can request remote FTP server directory listing using HsFtpCliList function, request to change current directory at remote FTP server with HsFtpCliChDr function or transfer binary files to and from remote FTP server with HsFtpCliSendFile and HsFtpCliGetFile functions.

The result of each operation is asynchronously notified via event callback with corresponding events.

Fragment of HS FTP interface header file

Sending files: The files are sent by HS FTP module in binary image mode (TYPE I) using passive mode data connections. Whenever HS FTP and underlying socket layer interface module HS SOCK are ready to transmit next block of file data, the user application is requested for next data block to send via event callback with HS_FTPCLI_USR_EV_TXSEG event.

Receiving Files: The files are received by HS FTP module in binary image mode (TYPE I) in passive data connection mode. Whenever the next block of data from the remote FTP server becomes available, the data is passed to the user application via event callback with HS_FTPCLI_USR_EV_RXSEG event.

HS FTP library is designed for single threaded, event driven environment, and includes built in socket interface layer library for asynchronous Win32 TCP/IP communications, the source code for which is also provided.

HS FTP C Source library has flexible modular architecture, portable to any OS with minimal or no effort

The underlying socket interface module HS SOCK provides support for TCP and UDP non blocking mode socket operation for both outbound and listening connections.

HS FTP allows concurrent FTP session operation. The number of sessions is limited by a define in the header file which can be bumped up for the required value, depending on functional requirement and memory restrictions. Below is HS FTP module context definition:

Typical File Sending Scenario

Typical File Reception Scenario