cam.3: do not discourage use of cam_open_device

[Andriy Gapon]

on 20/04/2010 21:01 Andriy Gapon said the following:
> This is based on my understanding what Scott Long tried to explain me a while ago.
> 
> Index: lib/libcam/cam.3
> ===================================================================
> --- lib/libcam/cam.3	(revision 206902)
> +++ lib/libcam/cam.3	(working copy)
> @@ -190,12 +190,6 @@
>  Once the device name and unit number
>  are determined, a lookup is performed to determine the passthrough device
>  that corresponds to the given device.
> -.Fn cam_open_device
> -is rather simple to use, but it is not really suitable for general use
> -because its behavior is not necessarily deterministic.
> -Programmers writing
> -new applications should make the extra effort to use one of the other open
> -routines documented below.
>  .Pp
>  .Fn cam_open_spec_device
>  opens the

If no one tries to stop me I will commit this.

> It seems that this warning about ambiguity came from pre-devfs days when e.g. cd0
> nodes in different directories could correspond to different actual SCSI
> peripherals.  It seems that there wasn't an ambiguity if an absolute device path
> was given.
> 
> Nowadays, cam_open_device seems to always do a proper job of finding a correct
> pass device.
> 


-- 
Andriy Gapon