cd_nmconv(3X)                                          cd_nmconv(3X)


       NAME
             cd_nmconv - set or get CD-ROM name conversion flag

       SYNOPSIS
             cc [flag . . . ] file . . . -lcdfs -lgen [library] . . .
             #include <sys/cdrom.h>
             int cd_nmconv(const char *path, int cmd, int *flag);

       DESCRIPTION
             cd_nmconv sets or gets the name conversion flag for file names
             on the mounted CD-ROM.  cd_nmconv provides a way to make the
             CD-ROM file names appear consistent with the names on the rest
             of the system.

             CD-ROM file identifiers take the following format:
                   FILENAME.FILENAME_EXTENSION;VERSION

             where FILENAME and FILENAME_EXTENSION are alphanumeric and
             VERSION is a number.

             If the name conversion flag needs to be set, set it after the
             CD-ROM has been mounted, but before any CD-ROM access occurs.
             If the command is executed while files are open, the changes
             will not take effect until the file is closed.

             path Mount point of a CD-ROM file system.

             cmd  CD_SETNMCONV to set the conversion flag or CD_GETNMCONV
                  to get the value of the conversion flag.

             flag flag is a pointer to one of the following:

                  CD_NOCONV No conversion

                  CD_LOWER  Convert characters in file identifiers to lower
                            case.  If a file identifier doesn't contain a
                            filename extension, don't display the period
                            (.).  You may use CD_LOWER and CD_NOVERSION
                            separately or together.

                  CD_NOVERSION
                            The version number and the semicolon (;) of a
                            File Identifier are not represented.  You may
                            use CD_LOWER and CD_NOVERSION separately or
                            together.



                           Copyright 1994 Novell, Inc.               Page 1

      cd_nmconv(3X)                                          cd_nmconv(3X)


         Return Values
            On success, cd_nmconv returns a value of zero.  On failure,
            cd_nmconv returns -1 and sets errno to identify the error.

         Errors
            EACCES    Read permission is denied on the mount point, or
                      search permission is denied on a component of path.

            EFAULT    Invalid address for flag or path.

            EINTR     A signal was caught during the execution of the
                      cd_nmconv function.

            EINVAL    The value of cmd or flag is invalid, or path
                      argument does not point to a mount point of a CD-ROM
                      file system.

            EMFILE    The maximum number of file descriptors are open.

            ENAMETOOLONG
                      The size of path exceeds MAXPATHLEN, or the
                      component of a path name is longer than MAXNAMELEN
                      while _POSIX_NO_TRUNC is in effect.

            ENFILE    The system file table is full.

            ENOENT    path does not exist or the path argument points to
                      an empty string.

            ENOTDIR   A component of path is not a directory.

            EPERM     User lacks write permission to set values.

      REFERENCES
            cdmntsuppl(1M), cdfs-specific mount(1M_CDFS)













                          Copyright 1994 Novell, Inc.               Page 2