#!/bin/bash # Find a free port and return it # # example: port=$(ynh_find_port --port=8080) # # usage: ynh_find_port --port=begin_port # | arg: -p, --port - port to start to search # # Requires YunoHost version 2.6.4 or higher. ynh_find_port () { # Declare an array to define the options of this helper. local legacy_args=p declare -Ar args_array=( [p]=port= ) local port # Manage arguments with getopts ynh_handle_getopts_args "$@" test -n "$port" || ynh_die --message="The argument of ynh_find_port must be a valid port." while ss -nltu | awk '{print$5}' | grep -q -E ":$port$" # Check if the port is free do port=$((port+1)) # Else, pass to next port done echo $port } # Test if a port is available # # example: ynh_port_available --port=1234 || ynh_die "Port 1234 is needs to be available for this app" # # usage: ynh_find_port --port=XYZ # | arg: -p, --port - port to check # # Requires YunoHost version 3.7.x or higher. ynh_port_available () { # Declare an array to define the options of this helper. local legacy_args=p declare -Ar args_array=( [p]=port= ) local port # Manage arguments with getopts ynh_handle_getopts_args "$@" if ss -nltu | grep -q -w :$port then return 1 else return 0 fi } # Validate an IP address # # usage: ynh_validate_ip --family=family --ip_address=ip_address # | ret: 0 for valid ip addresses, 1 otherwise # # example: ynh_validate_ip 4 111.222.333.444 # # Requires YunoHost version 2.2.4 or higher. ynh_validate_ip() { # http://stackoverflow.com/questions/319279/how-to-validate-ip-address-in-python#319298 # Declare an array to define the options of this helper. local legacy_args=fi declare -Ar args_array=( [f]=family= [i]=ip_address= ) local family local ip_address # Manage arguments with getopts ynh_handle_getopts_args "$@" [ "$family" == "4" ] || [ "$family" == "6" ] || return 1 python /dev/stdin << EOF import socket import sys family = { "4" : socket.AF_INET, "6" : socket.AF_INET6 } try: socket.inet_pton(family["$family"], "$ip_address") except socket.error: sys.exit(1) sys.exit(0) EOF } # Validate an IPv4 address # # example: ynh_validate_ip4 111.222.333.444 # # usage: ynh_validate_ip4 --ip_address=ip_address # | ret: 0 for valid ipv4 addresses, 1 otherwise # # Requires YunoHost version 2.2.4 or higher. ynh_validate_ip4() { # Declare an array to define the options of this helper. local legacy_args=i declare -Ar args_array=( [i]=ip_address= ) local ip_address # Manage arguments with getopts ynh_handle_getopts_args "$@" ynh_validate_ip 4 $ip_address } # Validate an IPv6 address # # example: ynh_validate_ip6 2000:dead:beef::1 # # usage: ynh_validate_ip6 --ip_address=ip_address # | ret: 0 for valid ipv6 addresses, 1 otherwise # # Requires YunoHost version 2.2.4 or higher. ynh_validate_ip6() { # Declare an array to define the options of this helper. local legacy_args=i declare -Ar args_array=( [i]=ip_address= ) local ip_address # Manage arguments with getopts ynh_handle_getopts_args "$@" ynh_validate_ip 6 $ip_address }