ftpz/twoprocess.h

#ifndef VSF_TWOPROCESS_H
#define VSF_TWOPROCESS_H

struct mystr;
struct vsf_session;

/* vsf_two_process_start()
 * PURPOSE
 * Called to start FTP login processing using the two process model. This
 * launches the unprivileged child to process the FTP login.
 * PARAMETERS
 * p_sess       - the current session object
 */
void vsf_two_process_start(struct vsf_session* p_sess);

/* vsf_two_process_login()
 * PURPOSE
 * Called to propose a login using the two process model.
 * PARAMETERS
 * p_sess       - the current session object
 * p_pass_str   - the proposed password
 */
void vsf_two_process_login(struct vsf_session* p_sess,
                           const struct mystr* p_pass_str);

/* vsf_two_process_get_priv_data_sock()
 * PURPOSE
 * Get a privileged port 20 bound data socket using the two process model.
 * PARAMETERS
 * p_sess       - the current session object
 * RETURNS
 * The file descriptor of the privileged socket
 */
int vsf_two_process_get_priv_data_sock(struct vsf_session* p_sess);

/* vsf_two_process_pasv_cleanup()
 * PURPOSE
 * Clean up any listening passive socket in the privileged side.
 * PARAMETERS
 * p_sess       - the current session object
 */
void vsf_two_process_pasv_cleanup(struct vsf_session* p_sess);

/* vsf_two_process_pasv_active()
 * PURPOSE
 * Determine if the passive socket is listening on the privileged side.
 * PARAMETERS
 * p_sess       - the current session object
 * RETURNS
 * 1 if active, 0 if not.
 */
int vsf_two_process_pasv_active(struct vsf_session* p_sess);

/* vsf_two_process_listen()
 * PURPOSE
 * Start listening for an incoming connection on the passive socket in the
 * privileged side.
 * PARAMETERS
 * p_sess       - the current session object
 * RETURNS
 * The port we listened on.
 */
unsigned short vsf_two_process_listen(struct vsf_session* p_sess);

/* vsf_two_process_get_pasv_fd()
 * PURPOSE
 * Accept an incoming connection on the passive socket in the privileged
 * side.
 * PARAMETERS
 * p_sess       - the current session object
 * RETURNS
 * The file descriptor for the incoming connection.
 */
int vsf_two_process_get_pasv_fd(struct vsf_session* p_sess);

/* vsf_two_process_chown_upload()
 * PURPOSE
 * Change ownership of an uploaded file using the two process model.
 * PARAMETERS
 * p_sess       - the current session object
 * fd           - the file descriptor to change ownership on
 */
void vsf_two_process_chown_upload(struct vsf_session* p_sess, int fd);

#endif /* VSF_TWOPROCESS_H */