bcs_match(1)
NAME
bcs_match − Retrieve a specific line from the hosts database
SYNOPSIS
/etc/bcs_match hosts.byname Internet_host_name
/etc/bcs_match hosts.byname Internet_host_alias
/etc/bcs_match hosts.byaddr Internet_host_address
DESCRIPTION
bcs_match provides Yellow Pages-like support to allow users to retrieve a specific line stored in the etc/hosts database. The command’s operation is independent of whether a CX system supports the NFS-oriented Yellow Pages. However, if a CX system is configured with Yellow Pages, bcs_match will use Yellow Pages to access the requested information. bcs_match emulates two C library networking routines. When used with the argument hosts.byname, the command operates similarly to the gethostbyname(3N) library routine, and when used with the hosts.byaddr argument, it functions similarly to the gethostbyaddr(3N) library routine.
The format of the arguments, Internet_host_name, Internet_host_alias, and Internet_host_address, is the same as given in the /etc/hosts file. Bcs_cat converts uppercase to lowercase for the Internet_host_name and Internet_host_alias arguments. The Internet_host_address argument must be given in dotted decimal notation.
The standard output of the command is the line containing the requested entry from the /etc/hosts file terminated by exactly two newline characters. If the requested Internet name, alias, or address was not found, the result of the command will be two newline characters. Both arguments must be given to bcs_match otherwise an error message will be produced. The command can only operate on one pair of arguments at a time.
NOTE
bcs_match is defined in the Binary Compatibility Standard (BCS) Networking Supplement.
FILES
/etc/hosts
SEE ALSO
bcs_cat(1), gethostbyname(3N), gethostbyaddr(3N), getnetbyaddr(3N), getnetbyname(3N), getprotobyname(3N), getprotobynumber(3N), getservbyname(3N), getservbyport(3N), hosts(4C), svcorder(4C)
CX/UX User’s Reference Manual