github.com/apache/beam/sdks/v2@v2.48.2/go/test/integration/internal/jars/proc_unix.go (about)

     1  // Licensed to the Apache Software Foundation (ASF) under one or more
     2  // contributor license agreements.  See the NOTICE file distributed with
     3  // this work for additional information regarding copyright ownership.
     4  // The ASF licenses this file to You under the Apache License, Version 2.0
     5  // (the "License"); you may not use this file except in compliance with
     6  // the License.  You may obtain a copy of the License at
     7  //
     8  //    http://www.apache.org/licenses/LICENSE-2.0
     9  //
    10  // Unless required by applicable law or agreed to in writing, software
    11  // distributed under the License is distributed on an "AS IS" BASIS,
    12  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13  // See the License for the specific language governing permissions and
    14  // limitations under the License.
    15  
    16  // Match build constraints of imported package golang.org/x/sys/unix.
    17  //go:build aix || darwin || dragonfly || freebsd || linux || netbsd || openbsd || solaris || zos
    18  // +build aix darwin dragonfly freebsd linux netbsd openbsd solaris zos
    19  
    20  package jars
    21  
    22  import (
    23  	"golang.org/x/sys/unix"
    24  	"os"
    25  )
    26  
    27  // UnixProcess wraps os.Process and changes the Kill function to perform a more
    28  // graceful shutdown, mainly for compatibility with the timeout command.
    29  type UnixProcess struct {
    30  	proc *os.Process // The os.Process for the running jar.
    31  }
    32  
    33  // Kill gracefully shuts down the process. It is recommended to use this
    34  // instead of directly killing the process.
    35  func (p *UnixProcess) Kill() error {
    36  	// Avoid using SIGKILL. If the jar is wrapped in the timeout command
    37  	// SIGKILL will kill the timeout and leave the jar running.
    38  	return p.proc.Signal(unix.SIGTERM)
    39  }