1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: generic Unix implementation of many wx functions
4 // Author: Vadim Zeitlin
6 // Copyright: (c) 1998 Robert Roebling, Vadim Zeitlin
7 // Licence: wxWindows licence
8 /////////////////////////////////////////////////////////////////////////////
10 // ============================================================================
12 // ============================================================================
14 // ----------------------------------------------------------------------------
16 // ----------------------------------------------------------------------------
19 #include "wx/string.h"
25 #include "wx/process.h"
26 #include "wx/thread.h"
28 #include "wx/stream.h"
31 #include "wx/unix/execute.h"
38 #include <sys/types.h>
45 #include <fcntl.h> // for O_WRONLY and friends
46 #include <time.h> // nanosleep() and/or usleep()
47 #include <ctype.h> // isspace()
48 #include <sys/time.h> // needed for FD_SETSIZE
51 #include <sys/utsname.h> // for uname()
54 // ----------------------------------------------------------------------------
55 // conditional compilation
56 // ----------------------------------------------------------------------------
58 // many versions of Unices have this function, but it is not defined in system
59 // headers - please add your system here if it is the case for your OS.
60 // SunOS < 5.6 (i.e. Solaris < 2.6) and DG-UX are like this.
61 #if !defined(HAVE_USLEEP) && \
62 (defined(__SUN__) && !defined(__SunOs_5_6) && \
63 !defined(__SunOs_5_7) && !defined(__SUNPRO_CC)) || \
64 defined(__osf__) || defined(__EMX__)
68 int usleep(unsigned int usec
);
71 /* I copied this from the XFree86 diffs. AV. */
72 #define INCL_DOSPROCESS
74 inline void usleep(unsigned long delay
)
76 DosSleep(delay
? (delay
/1000l) : 1l);
79 void usleep(unsigned long usec
);
81 #endif // Sun/EMX/Something else
85 #endif // Unices without usleep()
87 // ============================================================================
89 // ============================================================================
91 // ----------------------------------------------------------------------------
93 // ----------------------------------------------------------------------------
95 void wxSleep(int nSecs
)
100 void wxUsleep(unsigned long milliseconds
)
102 #if defined(HAVE_NANOSLEEP)
104 tmReq
.tv_sec
= (time_t)(milliseconds
/ 1000);
105 tmReq
.tv_nsec
= (milliseconds
% 1000) * 1000 * 1000;
107 // we're not interested in remaining time nor in return value
108 (void)nanosleep(&tmReq
, (timespec
*)NULL
);
109 #elif defined(HAVE_USLEEP)
110 // uncomment this if you feel brave or if you are sure that your version
111 // of Solaris has a safe usleep() function but please notice that usleep()
112 // is known to lead to crashes in MT programs in Solaris 2.[67] and is not
113 // documented as MT-Safe
114 #if defined(__SUN__) && wxUSE_THREADS
115 #error "usleep() cannot be used in MT programs under Solaris."
118 usleep(milliseconds
* 1000); // usleep(3) wants microseconds
119 #elif defined(HAVE_SLEEP)
120 // under BeOS sleep() takes seconds (what about other platforms, if any?)
121 sleep(milliseconds
* 1000);
122 #else // !sleep function
123 #error "usleep() or nanosleep() function required for wxUsleep"
124 #endif // sleep function
127 // ----------------------------------------------------------------------------
128 // process management
129 // ----------------------------------------------------------------------------
131 int wxKill(long pid
, wxSignal sig
)
133 return kill((pid_t
)pid
, (int)sig
);
136 #define WXEXECUTE_NARGS 127
138 long wxExecute( const wxString
& command
, bool sync
, wxProcess
*process
)
140 wxCHECK_MSG( !command
.IsEmpty(), 0, wxT("can't exec empty command") );
143 wxChar
*argv
[WXEXECUTE_NARGS
];
145 const wxChar
*cptr
= command
.c_str();
146 wxChar quotechar
= wxT('\0'); // is arg quoted?
147 bool escaped
= FALSE
;
149 // split the command line in arguments
153 quotechar
= wxT('\0');
155 // eat leading whitespace:
156 while ( wxIsspace(*cptr
) )
159 if ( *cptr
== wxT('\'') || *cptr
== wxT('"') )
164 if ( *cptr
== wxT('\\') && ! escaped
)
171 // all other characters:
175 // have we reached the end of the argument?
176 if ( (*cptr
== quotechar
&& ! escaped
)
177 || (quotechar
== wxT('\0') && wxIsspace(*cptr
))
178 || *cptr
== wxT('\0') )
180 wxASSERT_MSG( argc
< WXEXECUTE_NARGS
,
181 wxT("too many arguments in wxExecute") );
183 argv
[argc
] = new wxChar
[argument
.length() + 1];
184 wxStrcpy(argv
[argc
], argument
.c_str());
187 // if not at end of buffer, swallow last character:
191 break; // done with this one, start over
197 // do execute the command
198 long lRc
= wxExecute(argv
, sync
, process
);
203 delete [] argv
[argc
++];
208 bool wxShell(const wxString
& command
)
216 return wxExecute(cmd
) != 0;
221 void wxHandleProcessTermination(wxEndProcessData
*proc_data
)
223 int pid
= (proc_data
->pid
> 0) ? proc_data
->pid
: -(proc_data
->pid
);
225 // waitpid is POSIX so should be available everywhere, however on older
226 // systems wait() might be used instead in a loop (until the right pid
231 // wait for child termination and if waitpid() was interrupted, try again
234 rc
= waitpid(pid
, &status
, 0);
236 while ( rc
== -1 && errno
== EINTR
);
239 if( rc
== -1 || ! (WIFEXITED(status
) || WIFSIGNALED(status
)) )
241 wxLogSysError(_("Waiting for subprocess termination failed"));
242 /* AFAIK, this can only happen if something went wrong within
243 wxGTK, i.e. due to a race condition or some serious bug.
244 After having fixed the order of statements in
245 GTK_EndProcessDetector(). (KB)
250 // notify user about termination if required
251 if (proc_data
->process
)
253 proc_data
->process
->OnTerminate(proc_data
->pid
,
254 WEXITSTATUS(status
));
257 if ( proc_data
->pid
> 0 )
263 // wxExecute() will know about it
264 proc_data
->exitcode
= status
;
273 // ----------------------------------------------------------------------------
274 // wxStream classes to support IO redirection in wxExecute
275 // ----------------------------------------------------------------------------
277 class wxProcessFileInputStream
: public wxInputStream
280 wxProcessFileInputStream(int fd
) { m_fd
= fd
; }
281 ~wxProcessFileInputStream() { close(m_fd
); }
283 virtual bool Eof() const;
286 size_t OnSysRead(void *buffer
, size_t bufsize
);
292 class wxProcessFileOutputStream
: public wxOutputStream
295 wxProcessFileOutputStream(int fd
) { m_fd
= fd
; }
296 ~wxProcessFileOutputStream() { close(m_fd
); }
299 size_t OnSysWrite(const void *buffer
, size_t bufsize
);
305 bool wxProcessFileInputStream::Eof() const
307 if ( m_lasterror
== wxSTREAM_EOF
)
310 // check if there is any input available
317 FD_SET(m_fd
, &readfds
);
318 switch ( select(m_fd
+ 1, &readfds
, NULL
, NULL
, &tv
) )
321 wxLogSysError(_("Impossible to get child process input"));
328 wxFAIL_MSG(_T("unexpected select() return value"));
329 // still fall through
332 // input available: check if there is any
333 return wxInputStream::Eof();
337 size_t wxProcessFileInputStream::OnSysRead(void *buffer
, size_t bufsize
)
339 int ret
= read(m_fd
, buffer
, bufsize
);
342 m_lasterror
= wxSTREAM_EOF
;
344 else if ( ret
== -1 )
346 m_lasterror
= wxSTREAM_READ_ERROR
;
351 m_lasterror
= wxSTREAM_NOERROR
;
357 size_t wxProcessFileOutputStream::OnSysWrite(const void *buffer
, size_t bufsize
)
359 int ret
= write(m_fd
, buffer
, bufsize
);
362 m_lasterror
= wxSTREAM_WRITE_ERROR
;
367 m_lasterror
= wxSTREAM_NOERROR
;
373 long wxExecute(wxChar
**argv
,
377 wxCHECK_MSG( *argv
, 0, wxT("can't exec empty command") );
381 char *mb_argv
[WXEXECUTE_NARGS
];
383 while (argv
[mb_argc
])
385 wxWX2MBbuf mb_arg
= wxConvertWX2MB(argv
[mb_argc
]);
386 mb_argv
[mb_argc
] = strdup(mb_arg
);
389 mb_argv
[mb_argc
] = (char *) NULL
;
391 // this macro will free memory we used above
392 #define ARGS_CLEANUP \
393 for ( mb_argc = 0; mb_argv[mb_argc]; mb_argc++ ) \
394 free(mb_argv[mb_argc])
396 // no need for cleanup
399 wxChar
**mb_argv
= argv
;
400 #endif // Unicode/ANSI
404 int end_proc_detect
[2];
405 if ( pipe(end_proc_detect
) == -1 )
407 wxLogSysError( _("Pipe creation failed") );
408 wxLogError( _("Failed to execute '%s'\n"), *argv
);
418 pipeIn
[0] = pipeIn
[1] =
419 pipeOut
[0] = pipeOut
[1] = -1;
421 if ( process
&& process
->IsRedirected() )
423 if ( pipe(pipeIn
) == -1 || pipe(pipeOut
) == -1 )
426 // free previously allocated resources
427 close(end_proc_detect
[0]);
428 close(end_proc_detect
[1]);
431 wxLogSysError( _("Pipe creation failed") );
432 wxLogError( _("Failed to execute '%s'\n"), *argv
);
447 if ( pid
== -1 ) // error?
450 close(end_proc_detect
[0]);
451 close(end_proc_detect
[1]);
458 wxLogSysError( _("Fork failed") );
464 else if ( pid
== 0 ) // we're in child
467 close(end_proc_detect
[0]); // close reading side
470 // These lines close the open file descriptors to to avoid any
471 // input/output which might block the process or irritate the user. If
472 // one wants proper IO for the subprocess, the right thing to do is to
473 // start an xterm executing it.
476 for ( int fd
= 0; fd
< FD_SETSIZE
; fd
++ )
478 if ( fd
== pipeIn
[0] || fd
== pipeOut
[1]
480 || fd
== end_proc_detect
[1]
484 // don't close this one, we still need it
488 // leave stderr opened too, it won't do any hurm
489 if ( fd
!= STDERR_FILENO
)
494 // redirect stdio and stdout
495 // (TODO: what about stderr?)
496 if ( pipeIn
[0] != -1 )
498 if ( dup2(pipeIn
[0], STDIN_FILENO
) == -1 ||
499 dup2(pipeOut
[1], STDOUT_FILENO
) == -1 )
501 wxLogSysError(_("Failed to redirect child process "
509 execvp (*mb_argv
, mb_argv
);
511 // there is no return after successful exec()
514 else // we're in parent
518 // pipe initialization: construction of the wxStreams
519 if ( process
&& process
->IsRedirected() )
521 // These two streams are relative to this process.
522 wxOutputStream
*outStream
= new wxProcessFileOutputStream(pipeIn
[1]);
523 wxInputStream
*inStream
= new wxProcessFileInputStream(pipeOut
[0]);
524 close(pipeIn
[0]); // close reading side
525 close(pipeOut
[1]); // close writing side
527 process
->SetPipeStreams(inStream
, outStream
);
531 wxEndProcessData
*data
= new wxEndProcessData
;
535 // we may have process for capturing the program output, but it's
536 // not used in wxEndProcessData in the case of sync execution
537 data
->process
= NULL
;
539 // sync execution: indicate it by negating the pid
541 data
->tag
= wxAddProcessCallback(data
, end_proc_detect
[0]);
543 close(end_proc_detect
[1]); // close writing side
548 // it will be set to 0 from GTK_EndProcessDetector
549 while (data
->pid
!= 0)
552 int exitcode
= data
->exitcode
;
558 else // async execution
560 // async execution, nothing special to do - caller will be
561 // notified about the process termination if process != NULL, data
562 // will be deleted in GTK_EndProcessDetector
563 data
->process
= process
;
565 data
->tag
= wxAddProcessCallback(data
, end_proc_detect
[0]);
567 close(end_proc_detect
[1]); // close writing side
572 wxASSERT_MSG( sync
, wxT("async execution not supported yet") );
575 if ( waitpid(pid
, &exitcode
, 0) == -1 || !WIFEXITED(exitcode
) )
577 wxLogSysError(_("Waiting for subprocess termination failed"));
589 // ----------------------------------------------------------------------------
590 // file and directory functions
591 // ----------------------------------------------------------------------------
593 const wxChar
* wxGetHomeDir( wxString
*home
)
595 *home
= wxGetUserHome( wxString() );
596 if ( home
->IsEmpty() )
599 return home
->c_str();
603 const wxMB2WXbuf
wxGetUserHome( const wxString
&user
)
604 #else // just for binary compatibility -- there is no 'const' here
605 char *wxGetUserHome( const wxString
&user
)
608 struct passwd
*who
= (struct passwd
*) NULL
;
614 if ((ptr
= wxGetenv(wxT("HOME"))) != NULL
)
618 if ((ptr
= wxGetenv(wxT("USER"))) != NULL
|| (ptr
= wxGetenv(wxT("LOGNAME"))) != NULL
)
620 who
= getpwnam(wxConvertWX2MB(ptr
));
623 // We now make sure the the user exists!
626 who
= getpwuid(getuid());
631 who
= getpwnam (user
.mb_str());
634 return wxConvertMB2WX(who
? who
->pw_dir
: 0);
637 // ----------------------------------------------------------------------------
638 // network and user id routines
639 // ----------------------------------------------------------------------------
641 // retrieve either the hostname or FQDN depending on platform (caller must
642 // check whether it's one or the other, this is why this function is for
644 static bool wxGetHostNameInternal(wxChar
*buf
, int sz
)
646 wxCHECK_MSG( buf
, FALSE
, wxT("NULL pointer in wxGetHostNameInternal") );
650 // we're using uname() which is POSIX instead of less standard sysinfo()
651 #if defined(HAVE_UNAME)
653 bool ok
= uname(&uts
) != -1;
656 wxStrncpy(buf
, wxConvertMB2WX(uts
.nodename
), sz
- 1);
659 #elif defined(HAVE_GETHOSTNAME)
660 bool ok
= gethostname(buf
, sz
) != -1;
661 #else // no uname, no gethostname
662 wxFAIL_MSG(wxT("don't know host name for this machine"));
665 #endif // uname/gethostname
669 wxLogSysError(_("Cannot get the hostname"));
675 bool wxGetHostName(wxChar
*buf
, int sz
)
677 bool ok
= wxGetHostNameInternal(buf
, sz
);
681 // BSD systems return the FQDN, we only want the hostname, so extract
682 // it (we consider that dots are domain separators)
683 wxChar
*dot
= wxStrchr(buf
, wxT('.'));
694 bool wxGetFullHostName(wxChar
*buf
, int sz
)
696 bool ok
= wxGetHostNameInternal(buf
, sz
);
700 if ( !wxStrchr(buf
, wxT('.')) )
702 struct hostent
*host
= gethostbyname(wxConvertWX2MB(buf
));
705 wxLogSysError(_("Cannot get the official hostname"));
711 // the canonical name
712 wxStrncpy(buf
, wxConvertMB2WX(host
->h_name
), sz
);
715 //else: it's already a FQDN (BSD behaves this way)
721 bool wxGetUserId(wxChar
*buf
, int sz
)
726 if ((who
= getpwuid(getuid ())) != NULL
)
728 wxStrncpy (buf
, wxConvertMB2WX(who
->pw_name
), sz
- 1);
735 bool wxGetUserName(wxChar
*buf
, int sz
)
740 if ((who
= getpwuid (getuid ())) != NULL
)
742 // pw_gecos field in struct passwd is not standard
744 char *comma
= strchr(who
->pw_gecos
, ',');
746 *comma
= '\0'; // cut off non-name comment fields
747 wxStrncpy (buf
, wxConvertMB2WX(who
->pw_gecos
), sz
- 1);
748 #else // !HAVE_PW_GECOS
749 wxStrncpy (buf
, wxConvertMB2WX(who
->pw_name
), sz
- 1);
750 #endif // HAVE_PW_GECOS/!HAVE_PW_GECOS
757 wxString
wxGetOsDescription()
759 #ifndef WXWIN_OS_DESCRIPTION
760 #error WXWIN_OS_DESCRIPTION should be defined in config.h by configure
762 return WXWIN_OS_DESCRIPTION
;
766 // ----------------------------------------------------------------------------
767 // error and debug output routines (deprecated, use wxLog)
768 // ----------------------------------------------------------------------------
770 void wxDebugMsg( const char *format
, ... )
773 va_start( ap
, format
);
774 vfprintf( stderr
, format
, ap
);
779 void wxError( const wxString
&msg
, const wxString
&title
)
781 wxFprintf( stderr
, _("Error ") );
782 if (!title
.IsNull()) wxFprintf( stderr
, wxT("%s "), WXSTRINGCAST(title
) );
783 if (!msg
.IsNull()) wxFprintf( stderr
, wxT(": %s"), WXSTRINGCAST(msg
) );
784 wxFprintf( stderr
, wxT(".\n") );
787 void wxFatalError( const wxString
&msg
, const wxString
&title
)
789 wxFprintf( stderr
, _("Error ") );
790 if (!title
.IsNull()) wxFprintf( stderr
, wxT("%s "), WXSTRINGCAST(title
) );
791 if (!msg
.IsNull()) wxFprintf( stderr
, wxT(": %s"), WXSTRINGCAST(msg
) );
792 wxFprintf( stderr
, wxT(".\n") );
793 exit(3); // the same exit code as for abort()