Package org.jboss.as.process.logging

Interface ProcessLogger

  • All Superinterfaces:
    org.jboss.logging.BasicLogger
    All Known Implementing Classes:
    ProcessLogger_$logger
    @MessageLogger(projectCode="WFLYPC",
               length=4)
public interface ProcessLogger
extends org.jboss.logging.BasicLogger
    Date: 29.06.2011
    Author:
    James R. Perkins, Richard Opalka

    • Field Detail

      • ROOT_LOGGER

        static final ProcessLogger ROOT_LOGGER
        The root logger with a category of the package.

      • CLIENT_LOGGER

        static final ProcessLogger CLIENT_LOGGER
        A logger with the category org.jboss.as.process-controller.client.

      • PROTOCOL_LOGGER

        static final ProcessLogger PROTOCOL_LOGGER
        A logger with the category org.jboss.as.process.protocol

      • PROTOCOL_CLIENT_LOGGER

        static final ProcessLogger PROTOCOL_CLIENT_LOGGER
        A logger with the category org.jboss.as.process.protocol.client

      • PROTOCOL_CONNECTION_LOGGER

        static final ProcessLogger PROTOCOL_CONNECTION_LOGGER
        A logger with the category org.jboss.as.process.protocol.client

      • SERVER_LOGGER

        static final ProcessLogger SERVER_LOGGER
        A logger with the category org.jboss.as.process-controller.server.

    • Method Detail

      • attemptToReconnectNonExistentProcess

        @LogMessage(level=WARN)
@Message(id=1,
         value="Attempted to reconnect non-existent process \'%s\'")
void attemptToReconnectNonExistentProcess​(String processName)
        Logs a warning message indicating an attempt to reconnect a non-existent process.
        Parameters:
        processName - the name of the process.

      • attemptToRemoveNonExistentProcess

        @LogMessage(level=WARN)
@Message(id=2,
         value="Attempted to remove non-existent process \'%s\'")
void attemptToRemoveNonExistentProcess​(String processName)
        Logs a warning message indicating an attempt to remove a non-existent process.
        Parameters:
        processName - the name of the process.

      • attemptToStartNonExistentProcess

        @LogMessage(level=WARN)
@Message(id=3,
         value="Attempted to start non-existent process \'%s\'")
void attemptToStartNonExistentProcess​(String processName)
        Logs a warning message indicating an attempt to start a non-existent process.
        Parameters:
        processName - the name of the process.

      • attemptToStopNonExistentProcess

        @LogMessage(level=WARN)
@Message(id=4,
         value="Attempted to stop non-existent process \'%s\'")
void attemptToStopNonExistentProcess​(String processName)
        Logs a warning message indicating an attempt to stop a non-existent process.
        Parameters:
        processName - the name of the process.

      • duplicateProcessName

        @LogMessage(level=WARN)
@Message(id=5,
         value="Attempted to register duplicate named process \'%s\'")
void duplicateProcessName​(String processName)
        Logs a warning message indicating an attempt to register a duplicate named process.
        Parameters:
        processName - the duplicate name.

      • failedToSendAuthKey

        @LogMessage(level=WARN)
@Message(id=6,
         value="Failed to send authentication key to process \'%s\': %s")
void failedToSendAuthKey​(String processName,
                         Throwable error)
        Logs a warning message indicating the authentication key failed to send to the process.
        Parameters:
        processName - the process name.
        error - th error.

      • failedToSendDataBytes

        @LogMessage(level=ERROR)
@Message(id=7,
         value="Failed to send data bytes to process \'%s\' input stream")
void failedToSendDataBytes​(@Cause
                           Throwable cause,
                           String processName)
        Logs an error message indicating the data bytes failed to send to the process input stream.
        Parameters:
        cause - the cause of the error.
        processName - the process name.

      • failedToSendReconnect

        @LogMessage(level=ERROR)
@Message(id=8,
         value="Failed to send reconnect message to process \'%s\' input stream")
void failedToSendReconnect​(@Cause
                           Throwable cause,
                           String processName)
        Logs an error message indicating the reconnect message failed to send to the process input stream.
        Parameters:
        cause - the cause of the error.
        processName - the process name.

      • failedToStartProcess

        @LogMessage(level=ERROR)
@Message(id=9,
         value="Failed to start process \'%s\'")
void failedToStartProcess​(@Cause
                          Throwable cause,
                          String processName)
        Logs an error message indicating the process failed to start.
        Parameters:
        processName - the process name.

      • failedToWriteMessage

        @LogMessage(level=ERROR)
@Message(id=10,
         value="Failed to write %s message to connection: %s")
void failedToWriteMessage​(String messageType,
                          Throwable t)
        Logs an error message indicating a failure to write a message to the connection.
        Parameters:
        messageType - the type of the message that failed to write.
        t - the cause of the error.

      • processFinished

        @LogMessage(level=INFO)
@Message(id=11,
         value="Process \'%s\' finished with an exit status of %d")
void processFinished​(String processName,
                     int exitCode)
        Logs an informational message indicating the process has finished with the exit status code.
        Parameters:
        processName - the process name.
        exitCode - the exit code.

      • receivedInvalidVersion

        @LogMessage(level=WARN)
@Message(id=12,
         value="Received connection with invalid version from %s")
void receivedInvalidVersion​(InetAddress address)
        Logs a warning message indicating a connection with an invalid version from the address, represented by the address parameter, was received.
        Parameters:
        address - the address.

      • receivedUnknownGreetingCode

        @LogMessage(level=WARN)
@Message(id=13,
         value="Received unrecognized greeting code 0x%02x from %s")
void receivedUnknownGreetingCode​(int code,
                                 InetAddress address)
        Logs a warning message indicating an unknown greeting code, represented by the code parameter, was received by the address, represented by the address parameter.
        Parameters:
        code - the unknown code.
        address - the address

      • receivedUnknownCredentials

        @LogMessage(level=WARN)
@Message(id=14,
         value="Received connection with unknown credentials from %s")
void receivedUnknownCredentials​(InetAddress address)
        Logs a warning message indicating unknown credentials were received by the address, represented by the address parameter.
        Parameters:
        address - the address

      • receivedUnknownMessageCode

        @LogMessage(level=WARN)
@Message(id=15,
         value="Received unknown message with code 0x%02x")
void receivedUnknownMessageCode​(int code)
        Logs a warning message indicating an unknown message with the code, represented by the code parameter, was received.
        Parameters:
        code - the unknown code.

      • shutdownComplete

        @LogMessage(level=INFO)
@Message(id=16,
         value="All processes finished; exiting")
void shutdownComplete()
        Logs an informational message indicating the process controller shutdown is complete.

      • shuttingDown

        @LogMessage(level=INFO)
@Message(id=17,
         value="Shutting down process controller")
void shuttingDown()
        Logs an informational message indicating the process controller is shutting down.

      • startingProcess

        @LogMessage(level=INFO)
@Message(id=18,
         value="Starting process \'%s\'")
void startingProcess​(String processName)
        Logs an informational message indicating the process is starting.
        Parameters:
        processName - the process name.

      • stoppingProcess

        @LogMessage(level=INFO)
@Message(id=19,
         value="Stopping process \'%s\'")
void stoppingProcess​(String processName)
        Logs an informational message indicating the process is stopping.
        Parameters:
        processName - the process name.

      • streamProcessingFailed

        @LogMessage(level=ERROR)
@Message(id=20,
         value="Stream processing failed for process \'%s\': %s")
void streamProcessingFailed​(String processName,
                            Throwable error)
        Logs an error message indicating the stream processing failed for the process.
        Parameters:
        processName - the process name.
        error - the error.

      • waitingToRestart

        @LogMessage(level=INFO)
@Message(id=21,
         value="Waiting %d seconds until trying to restart process %s.")
void waitingToRestart​(int seconds,
                      String processName)
        Logs an informational message that the respawn is waiting until another attempt is made to restart the process.
        Parameters:
        seconds - the seconds
        processName - the process name

      • failedToKillProcess

        @LogMessage(level=WARN)
@Message(id=22,
         value="Failed to kill process \'%s\', trying to destroy the process instead.")
void failedToKillProcess​(String process)

      • argUsage

        @Message(id=0,
         value="Usage: %s [args...]%nwhere args include:")
String argUsage​(String executableName)

      • argBackup

        @Message(id=0,
         value="Keep a copy of the persistent domain configuration even if this host is not the Domain Controller. If ignore-unused-configuration is unset in host.xml, then the complete domain configuration will be stored, otherwise the configured value of ignore-unused-configuration will be used.")
String argBackup()
        Instructions for the CommandLineConstants.BACKUP_DC command line argument.
        Returns:
        the message.

      • argCachedDc

        @Message(id=0,
         value="If this host is not the Domain Controller and cannot contact the Domain Controller at boot, a locally cached copy of the domain configuration is used for boot (if available, see --backup.) The Domain Controller is background polled until it becomes available. Note that starting a host with --cached-dc when the Domain Controller is available will cache a copy of the domain configuration even if --backup is not used.")
String argCachedDc()
        Instructions for the CommandLineConstants.CACHED_DC command line argument.
        Returns:
        the message.

      • argDomainConfig

        @Message(id=0,
         value="Name of the domain configuration file to use (default is \"domain.xml\") (Same as -c)")
String argDomainConfig()
        Instructions for the CommandLineConstants.DOMAIN_CONFIG command line arguments.
        Returns:
        the message.

      • argShortDomainConfig

        @Message(id=0,
         value="Name of the domain configuration file to use (default is \"domain.xml\") (Same as --domain-config)")
String argShortDomainConfig()
        Instructions for the CommandLineConstants.SHORT_DOMAIN_CONFIG command line arguments.
        Returns:
        the message.

      • argReadOnlyDomainConfig

        @Message(id=0,
         value="Name of the domain configuration file to use. This differs from \'--domain-config\', \'-c\' and \'-domain-config\' in that the initial file is never overwritten.")
String argReadOnlyDomainConfig()
        Instructions for the CommandLineConstants.READ_ONLY_DOMAIN_CONFIG command line arguments.
        Returns:
        the message.

      • argInterProcessHcAddress

        @Message(id=0,
         value="Address on which the host controller should listen for communication from the process controller")
String argInterProcessHcAddress()
        Instructions for the CommandLineConstants.INTERPROCESS_HC_ADDRESS command line argument.
        Returns:
        the message.

      • argInterProcessHcPort

        @Message(id=0,
         value="Port on which the host controller should listen for communication from the process controller")
String argInterProcessHcPort()
        Instructions for the CommandLineConstants.INTERPROCESS_HC_PORT command line argument.
        Returns:
        the message.

      • argHostConfig

        @Message(id=0,
         value="Name of the host configuration file to use (default is \"host.xml\")")
String argHostConfig()
        Instructions for the CommandLineConstants.HOST_CONFIG command line argument.
        Returns:
        the message.

      • argReadOnlyHostConfig

        @Message(id=0,
         value="Name of the host configuration file to use. This differs from \'--host-config\' in that the initial file is never overwritten.")
String argReadOnlyHostConfig()
        Instructions for the CommandLineConstants.READ_ONLY_HOST_CONFIG command line argument.
        Returns:
        the message.

      • argPublicBindAddress

        @Message(id=0,
         value="Set system property jboss.bind.address to the given value")
String argPublicBindAddress()
        Instructions for the CommandLineConstants.PUBLIC_BIND_ADDRESS command line argument.
        Returns:
        the message.

      • argInterfaceBindAddress

        @Message(id=0,
         value="Set system property jboss.bind.address.<interface> to the given value")
String argInterfaceBindAddress()
        Instructions for the -b<interface></interface> command line argument.
        Returns:
        the message.

      • argDefaultMulticastAddress

        @Message(id=0,
         value="Set system property jboss.default.multicast.address to the given value")
String argDefaultMulticastAddress()
        Instructions for the CommandLineConstants.DEFAULT_MULTICAST_ADDRESS command line argument.
        Returns:
        the message.

      • argAdminOnly

        @Message(id=0,
         value="Set the host controller\'s running type to ADMIN_ONLY causing it to open administrative interfaces and accept management requests but not start servers or, if this host controller is the primary for the domain, accept incoming connections from secondary host controllers.")
String argAdminOnly()
        Instructions for the CommandLineConstants.ADMIN_ONLY command line argument.
        Returns:
        the message.

      • argMasterAddress

        @Message(id=0,
         value="Set system property jboss.domain.primary.address to the given value. In a default secondary Host Controller config, this is used to configure the address of the primary Host Controller.")
String argMasterAddress()
        Instructions for the CommandLineConstants.PRIMARY_ADDRESS command line argument.
        Returns:
        the message.

      • argMasterPort

        @Message(id=0,
         value="Set system property jboss.domain.primary.port to the given value. In a default secondary Host Controller config, this is used to configure the port used for native management communication by the primary Host Controller.")
String argMasterPort()
        Instructions for the CommandLineConstants.PRIMARY_PORT command line argument.
        Returns:
        the message.

      • argSecMgr

        @Message(id=0,
         value="Runs the server with a security manager installed.")
String argSecMgr()
        Instructions for the CommandLineConstants.SECMGR command line argument.
        Returns:
        the message

      • argStability

        @Message(id=0,
         value="Runs the server using a specific stability level.  Possible values: %s, Default = %s")
String argStability​(Set<Stability> stabilities,
                    Stability defaultStability)
        Instructions for the CommandLineConstants.STABILITY command line argument.
        Returns:
        the message

      • noArgValue

        @Message(id=23,
         value="No value was provided for argument %s")
String noArgValue​(String argument)
        Error message indicating no value was provided for a command line argument.
        Parameters:
        argument - the name of the argument
        Returns:
        the message.

      • invalidAuthKeyLen

        @Message(id=25,
         value="Authentication key must be 24 bytes long")
IllegalArgumentException invalidAuthKeyLen()
        Creates an exception indicating the authentication key must be 16 bytes long.
        Returns:
        an IllegalArgumentException for the error.

      • invalidLength

        @Message(id=29,
         value="%s length is invalid")
IllegalArgumentException invalidLength​(String parameterName)
        Creates an exception indicating the parameter has an invalid length.
        Parameters:
        parameterName - the parameter name.
        Returns:
        an IllegalArgumentException for the error.

      • invalidOption

        @Message(id=30,
         value="Invalid option: %s")
IllegalArgumentException invalidOption​(String option)
        Creates an exception indicating the option, represented by the option parameter, is invalid.
        Parameters:
        option - the invalid option.
        Returns:
        an IllegalArgumentException for the error.

      • nullCommandComponent

        @Message(id=31,
         value="Command contains a null component")
IllegalArgumentException nullCommandComponent()
        Creates an exception indicating a command contains a null component.
        Returns:
        an IllegalArgumentException for the error.

      • failedToAcceptConnection

        @LogMessage(level=ERROR)
@Message(id=33,
         value="Failed to accept a connection")
void failedToAcceptConnection​(@Cause
                              Throwable cause)
        Logs an error message indicating a failure to accept the connection.
        Parameters:
        cause - the cause of the error.

      • failedToCloseResource

        @LogMessage(level=ERROR)
@Message(id=34,
         value="Failed to close resource %s")
void failedToCloseResource​(@Cause
                           Throwable cause,
                           Object resource)
        Logs an error message indicating a failure to close the resource.
        Parameters:
        cause - the cause of the error.
        resource - the resource.

      • failedToCloseServerSocket

        @LogMessage(level=ERROR)
@Message(id=35,
         value="Failed to close the server socket %s")
void failedToCloseServerSocket​(@Cause
                               Throwable cause,
                               ServerSocket socket)
        Logs an error message indicating a failure to close the server socket.
        Parameters:
        cause - the cause of the error.
        socket - the server socket.

      • failedToCloseSocket

        @LogMessage(level=ERROR)
@Message(id=36,
         value="Failed to close a socket")
void failedToCloseSocket​(@Cause
                         Throwable cause)
        Logs an error message indicating a failure to close the socket.
        Parameters:
        cause - the cause of the error.

      • failedToHandleIncomingConnection

        @LogMessage(level=ERROR)
@Message(id=39,
         value="Failed to handle incoming connection")
void failedToHandleIncomingConnection​(@Cause
                                      Throwable cause)
        Logs an error message indicating a failure to handle the incoming connection.
        Parameters:
        cause - the cause of the error.

      • failedToHandleSocketFailure

        @LogMessage(level=ERROR)
@Message(id=40,
         value="Failed to handle socket failure condition")
void failedToHandleSocketFailure​(@Cause
                                 Throwable cause)
        Logs an error messaged indicating a failure to handle the socket failure condition.
        Parameters:
        cause - the cause of the error.

      • failedToHandleSocketFinished

        @LogMessage(level=ERROR)
@Message(id=41,
         value="Failed to handle socket finished condition")
void failedToHandleSocketFinished​(@Cause
                                  Throwable cause)
        Logs an error messaged indicating a failure to handle the socket finished condition.
        Parameters:
        cause - the cause of the error.

      • failedToHandleSocketShutdown

        @LogMessage(level=ERROR)
@Message(id=42,
         value="Failed to handle socket shut down condition")
void failedToHandleSocketShutdown​(@Cause
                                  Throwable cause)
        Logs an error messaged indicating a failure to handle the socket shut down condition.
        Parameters:
        cause - the cause of the error.

      • failedToReadMessage

        @LogMessage(level=ERROR)
@Message(id=43,
         value="Failed to read a message")
void failedToReadMessage​(@Cause
                         Throwable cause)
        Logs an error message indicating a failure to read a message.
        Parameters:
        cause - the cause of the error.

      • leakedMessageOutputStream

        @LogMessage(level=WARN)
@Message(id=44,
         value="Leaked a message output stream; cleaning")
void leakedMessageOutputStream()
        Logs a warning message indicating the leakage of the message outout stream.

      • failedToCreateServerThread

        @Message(id=45,
         value="Failed to create server thread")
IOException failedToCreateServerThread()
        Creates an exception indicating a failure to create the server thread.
        Returns:
        an IOException for the error.

      • failedToReadObject

        @Message(id=46,
         value="Failed to read object")
IOException failedToReadObject​(@Cause
                               Throwable cause)
        Creates an exception indicating a failure to read the object.
        Parameters:
        cause - the cause of the error.
        Returns:
        an IOException for the error.

      • invalidByte

        @Message(id=48,
         value="Invalid byte:%s(%d)")
UTFDataFormatException invalidByte​(char c,
                                   int i)
        Creates an exception indicating an invalid byte.
        Parameters:
        c - the character.
        i - the raw integer.
        Returns:
        an UTFDataFormatException for the error.

      • invalidByteToken

        @Message(id=49,
         value="Invalid byte token.  Expecting \'%s\' received \'%s\'")
IOException invalidByteToken​(int expected,
                             byte actual)
        Creates an exception indicating an invalid byte token was found.
        Parameters:
        expected - the expected value.
        actual - the actual value.
        Returns:
        an IOException for the error.

      • invalidCommandByte

        @Message(id=50,
         value="Invalid command byte read: %s")
IOException invalidCommandByte​(int commandByte)
        Creates an exception indicating an invalid command byte was read.
        Parameters:
        commandByte - the command byte read.
        Returns:
        an IOException for the error.

      • invalidStartChunk

        @Message(id=51,
         value="Invalid start chunk start [%s]")
IOException invalidStartChunk​(int chunk)
        Creates an exception indicating an invalid start chunk was found.
        Parameters:
        chunk - the start chunk.
        Returns:
        an IOException for the error.

      • readBytes

        @Message(id=56,
         value="Read %d bytes.")
EOFException readBytes​(int bytesRead)
        Creates an exception indicating the number of bytes read.
        Parameters:
        bytesRead - the number of bytes read.
        Returns:
        an EOFException for the error.

      • streamClosed

        @Message(id=58,
         value="Stream closed")
IOException streamClosed()
        Creates an exception indicating the stream is closed.
        Returns:
        an IOException for the error.

      • threadCreationRefused

        @Message(id=59,
         value="Thread creation was refused")
IllegalStateException threadCreationRefused()
        Creates an exception indicating the thread creation was refused.
        Returns:
        an IllegalStateException for the error.

      • unexpectedEndOfStream

        @Message(id=60,
         value="Unexpected end of stream")
EOFException unexpectedEndOfStream()
        Creates an exception indicating an unexpected end of stream was detected.
        Returns:
        an EOFException for the error.

      • writeChannelClosed

        @Message(id=61,
         value="Write channel closed")
IOException writeChannelClosed()
        Creates an exception indicating the write channel is closed.
        Returns:
        an IOException for the error.

      • writesAlreadyShutdown

        @Message(id=62,
         value="Writes are already shut down")
IOException writesAlreadyShutdown()
        Creates an exception indicating the writes have already been shutdown.
        Returns:
        an IOException for the error.

      • attemptingToKillProcess

        @LogMessage(level=INFO)
@Message(id=63,
         value="Process \'%s\' did not complete normal stop within %d ms; attempting to kill process using OS calls")
void attemptingToKillProcess​(String process,
                             long timeout)

      • jpsCommandNotFound

        @LogMessage(level=INFO)
@Message(id=64,
         value="Cannot locate process \'%s\' -- could not find the \'jps\' command")
void jpsCommandNotFound​(String process)

      • processNotFound

        @LogMessage(level=INFO)
@Message(id=65,
         value="No process identifiable as \'%s\' could be found")
void processNotFound​(String process)

      • multipleProcessesFound

        @LogMessage(level=INFO)
@Message(id=66,
         value="Multiple processes identifiable as \'%s\' found; OS level kill cannot be safely performed")
void multipleProcessesFound​(String process)

      • destroyingProcess

        @LogMessage(level=INFO)
@Message(id=67,
         value="Process \'%s\' did not complete normal stop within %d ms; attempting to destroy process using java.lang.Process.destroyForcibly()")
void destroyingProcess​(String process,
                       long timeout)