public class StandardOutputStream extends OutputStream
stdout
with fd=1 as the stream to write to for the channel.
Using stdin/stdout pair for the communication is very convenient for setting up a remote channel,
so Jenkins tends to do that, but even with our using System.setOut(PrintStream)
to avoid
other parts of the Java code to accidentally corrupt the stream, file descriptor 1 continues to
point to the stream we use, so native code in JVM can still accidentally pollute the stream.
Fixing that requires the use of dup and close POSIX API calls, which we can only do after the communication
gets established and JNA is brought in via remoting. Having Launcher
uses this wrapper class allows
us to do that without recreating the stream.
When a channel uses StandardOutputStream
to communicate, the convention is to make that object
available as a channel property.
Constructor and Description |
---|
StandardOutputStream() |
Modifier and Type | Method and Description |
---|---|
void |
close() |
void |
flush() |
boolean |
isSwapped() |
OutputStream |
swap(OutputStream another)
Atomically swaps the underlying stream to another stream and returns it.
|
void |
write(byte[] b) |
void |
write(byte[] b,
int off,
int len) |
void |
write(int b) |
public OutputStream swap(OutputStream another)
public boolean isSwapped()
public void write(int b) throws IOException
write
in class OutputStream
IOException
public void write(@NonNull byte[] b) throws IOException
write
in class OutputStream
IOException
public void write(@NonNull byte[] b, int off, int len) throws IOException
write
in class OutputStream
IOException
public void flush() throws IOException
flush
in interface Flushable
flush
in class OutputStream
IOException
public void close() throws IOException
close
in interface Closeable
close
in interface AutoCloseable
close
in class OutputStream
IOException
Copyright © 2004–2022. All rights reserved.