xref: /titanic_41/usr/src/cmd/Adm/ttysrch (revision aecfc01d1bad84e66649703f7fc2926ef70b34ba)
17c478bd9Sstevel@tonic-gate#
2*aecfc01dSrui zang - Sun Microsystems - Beijing China# Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
37c478bd9Sstevel@tonic-gate# Use is subject to license terms.
47c478bd9Sstevel@tonic-gate#
57c478bd9Sstevel@tonic-gate# CDDL HEADER START
67c478bd9Sstevel@tonic-gate#
77c478bd9Sstevel@tonic-gate# The contents of this file are subject to the terms of the
8*aecfc01dSrui zang - Sun Microsystems - Beijing China# Common Development and Distribution License (the "License").
9*aecfc01dSrui zang - Sun Microsystems - Beijing China# You may not use this file except in compliance with the License.
107c478bd9Sstevel@tonic-gate#
117c478bd9Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
127c478bd9Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
137c478bd9Sstevel@tonic-gate# See the License for the specific language governing permissions
147c478bd9Sstevel@tonic-gate# and limitations under the License.
157c478bd9Sstevel@tonic-gate#
167c478bd9Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
177c478bd9Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
187c478bd9Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
197c478bd9Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
207c478bd9Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
217c478bd9Sstevel@tonic-gate#
227c478bd9Sstevel@tonic-gate# CDDL HEADER END
237c478bd9Sstevel@tonic-gate#
247c478bd9Sstevel@tonic-gate#	This file is used by ttyname(3C) to minimize search time
257c478bd9Sstevel@tonic-gate#	during attempts to determine the name of a terminal device.
267c478bd9Sstevel@tonic-gate#
277c478bd9Sstevel@tonic-gate#	This is done by providing the names of directories which
287c478bd9Sstevel@tonic-gate#	are most likely to contain device entries for terminal
297c478bd9Sstevel@tonic-gate#	devices. These directories will be searched in the order
307c478bd9Sstevel@tonic-gate#	listed prior to an exhaustive search of the rest of /dev.
317c478bd9Sstevel@tonic-gate#
327c478bd9Sstevel@tonic-gate#	Each line contains the name of a directory (which must
337c478bd9Sstevel@tonic-gate#	begin with "/dev") and (optionally) a set of flags which
347c478bd9Sstevel@tonic-gate#	modify the criteria used to determine a match. By default,
357c478bd9Sstevel@tonic-gate#	an exact match requires that the major/minor device number
367c478bd9Sstevel@tonic-gate#	(the M flag), the file system identifier (the F flag), and
377c478bd9Sstevel@tonic-gate#	the inode number (the I flag) all match.  Normally, a partial
387c478bd9Sstevel@tonic-gate#	match on the major/minor device and the file system identifier
397c478bd9Sstevel@tonic-gate#	is accepted only after exhausting all entries under /dev.
407c478bd9Sstevel@tonic-gate#	By specifying only the M and F flags, an exact match will
417c478bd9Sstevel@tonic-gate#	be accepted regardless of the value of the inode number as
427c478bd9Sstevel@tonic-gate#	soon as it is found.  This is especially useful for cloned
437c478bd9Sstevel@tonic-gate#	devices, which generally will not match inode numbers.
447c478bd9Sstevel@tonic-gate#
457c478bd9Sstevel@tonic-gate#	For additional information see ttysrch(4).
467c478bd9Sstevel@tonic-gate#
477c478bd9Sstevel@tonic-gate# EXAMPLE:
487c478bd9Sstevel@tonic-gate#
497c478bd9Sstevel@tonic-gate#	/dev/slan	MF
507c478bd9Sstevel@tonic-gate#
517c478bd9Sstevel@tonic-gate#	This would improve performance for Starlan network connections
527c478bd9Sstevel@tonic-gate#	if all Starlan network clone device entries were contained
537c478bd9Sstevel@tonic-gate#	in the /dev/slan directory.
547c478bd9Sstevel@tonic-gate#
557c478bd9Sstevel@tonic-gate/dev/pts
56*aecfc01dSrui zang - Sun Microsystems - Beijing China/dev/vt
577c478bd9Sstevel@tonic-gate/dev/term
587c478bd9Sstevel@tonic-gate/dev/zcons
59