You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
149 lines
4.4 KiB
149 lines
4.4 KiB
/* vi: ts=8 sts=4 sw=4
|
|
*
|
|
*
|
|
* This file is part of the KDE project, module tdesu.
|
|
* Copyright (C) 1999,2000 Geert Jansen <jansen@kde.org>
|
|
*
|
|
* This is free software; you can use this library under the GNU Library
|
|
* General Public License, version 2. See the file "COPYING.LIB" for the
|
|
* exact licensing terms.
|
|
*/
|
|
|
|
#ifndef __Process_h_Included__
|
|
#define __Process_h_Included__
|
|
|
|
#include <tqcstring.h>
|
|
#include <tqstring.h>
|
|
#include <tqstringlist.h>
|
|
#include <tqvaluelist.h>
|
|
|
|
#define PTYPROC 7120
|
|
|
|
class PTY;
|
|
typedef TQValueList<TQCString> QCStringList;
|
|
|
|
/**
|
|
* Synchronous communication with tty programs.
|
|
*
|
|
* PtyProcess provides synchronous communication with tty based programs.
|
|
* The communications channel used is a pseudo tty (as opposed to a pipe)
|
|
* This means that programs which require a terminal will work.
|
|
*/
|
|
|
|
class MyPtyProcess
|
|
{
|
|
public:
|
|
MyPtyProcess();
|
|
virtual ~MyPtyProcess();
|
|
|
|
/**
|
|
* Fork off and execute a command. The command's standard in and output
|
|
* are connected to the pseudo tty. They are accessible with @ref #readLine
|
|
* and @ref #writeLine.
|
|
* @param command The command to execute.
|
|
* @param args The arguments to the command.
|
|
*/
|
|
int exec(TQCString command, QCStringList args);
|
|
|
|
/**
|
|
* Read a line from the program's standard out. Depending on the @em block
|
|
* parameter, this call blocks until a single, full line is read.
|
|
* @param block Block until a full line is read?
|
|
* @return The output string.
|
|
*/
|
|
TQCString readLine(bool block = true)
|
|
{ return readLineFrom(m_Fd, m_ptyBuf, block); }
|
|
|
|
TQCString readLineFromPty(bool block = true)
|
|
{ return readLineFrom(m_Fd, m_ptyBuf, block); }
|
|
|
|
TQCString readLineFromStdout(bool block = true)
|
|
{ return readLineFrom(m_stdinout, m_stdoutBuf, block); }
|
|
|
|
TQCString readLineFromStderr(bool block = true)
|
|
{ return readLineFrom(m_err, m_stderrBuf, block); }
|
|
|
|
/**
|
|
* Write a line of text to the program's standard in.
|
|
* @param line The text to write.
|
|
* @param addNewline Adds a '\n' to the line.
|
|
*/
|
|
void writeLine(TQCString line, bool addNewline=true);
|
|
|
|
/**
|
|
* Put back a line of input.
|
|
* @param line The line to put back.
|
|
* @param addNewline Adds a '\n' to the line.
|
|
*/
|
|
|
|
void unreadLine(TQCString line, bool addNewline = true)
|
|
{ unreadLineFrom(m_ptyBuf, line, addNewline); }
|
|
|
|
void unreadLineFromPty(TQCString line, bool addNewline = true)
|
|
{ unreadLineFrom(m_ptyBuf, line, addNewline); }
|
|
|
|
void unreadLineFromStderr(TQCString line, bool addNewline = true)
|
|
{ unreadLineFrom(m_stderrBuf, line, addNewline); }
|
|
|
|
void unreadLineFromStdout(TQCString line, bool addNewline = true)
|
|
{ unreadLineFrom(m_stdoutBuf, line, addNewline); }
|
|
|
|
/**
|
|
* Set exit string. If a line of program output matches this,
|
|
* @ref #waitForChild() will terminate the program and return.
|
|
*/
|
|
void setExitString(TQCString exit) { m_Exit = exit; }
|
|
|
|
/**
|
|
* Wait for the child to exit. See also @ref #setExitString.
|
|
*/
|
|
int waitForChild();
|
|
|
|
/**
|
|
* Wait until the pty has cleared the ECHO flag. This is useful
|
|
* when programs write a password prompt before they disable ECHO.
|
|
* Disabling it might flush any input that was written.
|
|
*/
|
|
int WaitSlave();
|
|
|
|
/** Enables/disables local echo on the pseudo tty. */
|
|
int enableLocalEcho(bool enable=true);
|
|
|
|
/** Enable/disable terminal output. Relevant only to some subclasses. */
|
|
void setTerminal(bool terminal) { m_bTerminal = terminal; }
|
|
|
|
/** Overwritte the password as soon as it is used. Relevant only to
|
|
* some subclasses. */
|
|
void setErase(bool erase) { m_bErase = erase; }
|
|
|
|
/** Return the filedescriptor of the process. */
|
|
int fd() {return m_Fd;}
|
|
|
|
/** Return the pid of the process. */
|
|
int pid() {return m_Pid;}
|
|
|
|
int stdioFd() {return m_stdinout;}
|
|
|
|
int stderrFd() {return m_err;}
|
|
|
|
protected:
|
|
bool m_bErase, m_bTerminal;
|
|
int m_Pid, m_Fd, m_stdinout, m_err;
|
|
TQCString m_Command, m_Exit;
|
|
|
|
private:
|
|
int init();
|
|
int SetupTTY(int fd);
|
|
|
|
PTY *m_pPTY;
|
|
TQCString m_TTY;
|
|
TQCString m_ptyBuf, m_stderrBuf, m_stdoutBuf;
|
|
|
|
TQCString readLineFrom(int fd, TQCString& inbuf, bool block);
|
|
void unreadLineFrom(TQCString inbuf, TQCString line, bool addnl);
|
|
class PtyProcessPrivate;
|
|
PtyProcessPrivate *d;
|
|
};
|
|
|
|
#endif
|