Imported Upstream version 4.2-build2006upstream/4.2-build2006upstream

3 files changed, 1160 insertions, 0 deletions

diff --git a/cmd/ossdevlinks/.config b/cmd/ossdevlinks/.config
new file mode 100644
index 0000000..cb9df11
--- /dev/null
+++ b/cmd/ossdevlinks/.config
@@ -0,0 +1,4 @@
+mode=sbin
+forgetos=BeOS
+forgetos=Haiku
+forgetos=VxWorks
diff --git a/cmd/ossdevlinks/ossdevlinks.c b/cmd/ossdevlinks/ossdevlinks.c
new file mode 100644
index 0000000..a19039f
--- /dev/null
+++ b/cmd/ossdevlinks/ossdevlinks.c
@@ -0,0 +1,1113 @@
+/*
+ * Purpose: Legacy sound device management utility
+ *
+ * Description:
+ * Device file naming scheme was changed in OSS 4.0. This utility is used
+ * to create old style "legacy" device files such as /dev/dsp0 to the
+ * corresponding new type name (such as /dev/oss/oss_sblive0/pcm0).
+ *
+ * By default the currently existing device links will be preserved. Legacy
+ * devices for newly installed devices will be allocated after the
+ * previously available devices.
+ *
+ * Commad line options:
+ * -f      Write legacydev file to <argument>.
+ * -v      Produce verbose output.
+ * -r      Remove all pre-existing legacy devices and reset the device
+ *         numbering (not recommended).
+ * -N      Don't modify links
+ */
+/*
+ *
+ * This file is part of Open Sound System.
+ *
+ * Copyright (C) 4Front Technologies 1996-2008.
+ *
+ * This this source file is released under GPL v2 license (no other versions).
+ * See the COPYING file included in the main directory of this source
+ * distribution for the license terms and conditions.
+ *
+ */
+
+#include <stdio.h>
+#include <unistd.h>
+#include <stdlib.h>
+#include <string.h>
+#include <fcntl.h>
+#include <dirent.h>
+#include <fnmatch.h>
+#include <errno.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <sys/ioctl.h>
+#include "oss_config.h"
+
+#define MAXDEV	HARD_MAX_AUDIO_DEVFILES
+
+static oss_sysinfo si;
+#ifdef sun
+  static char * legacydev_file = "/etc/oss/legacy_devices";
+#else
+  static char * legacydev_file = NULL;
+#endif
+static int err = 0, mixerfd = -1, recreate_all = 0, verbose = 0,
+           no_links = 0;
+
+static void create_dsplinks (void);
+static void create_mixerlinks (void);
+static int find_dsplink (oss_audioinfo *);
+static int find_mixerlink (oss_mixerinfo *);
+static void save_link (FILE *, char *);
+static void save_links (void);
+static int remove_nodes (const char *, const char *);
+#ifdef CONFIG_OSS_MIDI
+static void create_midilinks (void);
+static int find_midilink (oss_midi_info *);
+#endif
+
+#if PATH_MAX == -1
+#undef PATH_MAX
+#endif 
+#ifndef PATH_MAX
+#define PATH_MAX 1024 
+#endif
+
+#if defined(sun)
+#define DEFAULT_OSSLIBDIR "/etc/oss"
+#else
+#define DEFAULT_OSSLIBDIR "/usr/lib/oss"
+#endif
+
+static char *
+get_mapname (void)
+{
+  FILE *f;
+#define OSSLIBDIRLEN PATH_MAX
+  char tmp[OSSLIBDIRLEN+11];
+  static char name[OSSLIBDIRLEN];
+  struct stat st;
+
+  if ((f = fopen ("/etc/oss.conf", "r")) == NULL)
+    {
+      // perror ("/etc/oss.conf");
+      goto oexit;
+    }
+
+  while (fgets (tmp, sizeof (tmp), f) != NULL)
+    {
+      int l = strlen (tmp);
+      if (l > 0 && tmp[l - 1] == '\n')
+	tmp[l - 1] = '\0';
+
+      if (strncmp (tmp, "OSSLIBDIR=", 10) == 0)
+	{
+	  l = snprintf (name, sizeof (name), "%s", &tmp[10]);
+	  if ((l >= OSSLIBDIRLEN) || (l < 0))
+	    {
+	      fprintf (stderr, "String in /etc/oss.conf is too long!\n");
+	      goto oexit;
+	    }
+	  if ((stat (name, &st) == -1) || !S_ISDIR(st.st_mode))
+	    {
+	      fprintf (stderr, "Directory %s from /etc/oss.conf cannot "
+			       "be used!\n", name);
+	      goto oexit;
+	    }
+	  fclose (f);
+	  return name;
+	}
+    }
+
+oexit:
+  fclose (f);
+  snprintf (name, sizeof (name), DEFAULT_OSSLIBDIR);
+  return name;
+}
+
+static int
+remove_nodes (const char * dirname, const char * pattern)
+{
+  char path[PATH_MAX];
+  DIR * dr;
+  struct dirent * de;
+  struct stat st;
+
+  if ((dr = opendir (dirname)) == NULL)
+    {
+      if (errno == ENOENT) return 0;
+      fprintf (stderr, "Cannot open %s\n", dirname);
+      perror ("opendir");
+      return -1;
+    }
+
+  while ((de = readdir (dr)) != NULL)
+    {
+      if (fnmatch (pattern, de->d_name, FNM_PATHNAME | FNM_PERIOD)) continue;
+
+      snprintf (path, sizeof (path), "%s/%s", dirname, de->d_name);
+
+      /* We want to remove dangling symlinks too, so no error check here */
+      if ((stat (path, &st) != -1) &&
+      /* No nodes that ossdevlinks may need to remove are directories */
+          (S_ISDIR (st.st_mode))) continue;
+      if (verbose > 2) fprintf (stderr, "Removing %s\n", path);
+      if ((unlink (path) == -1) && (errno != ENOENT))
+        fprintf (stderr, "unlink %s: %s\n", path, strerror(errno));
+    }
+
+  closedir (dr);
+  return 0;
+}
+
+/*
+ *****************************
+ * /dev/dsp handling
+ */
+
+static int
+find_dsplink (oss_audioinfo * ai)
+{
+  int dev;
+/*
+ * Look for a legacy (/dev/dsp#) devife file that is a symlink to
+ * ai->devnode. Return the device number if a
+ * matching link is found. Return -1 if nothing is found.
+ */
+
+  struct stat st;
+  char devname[64], linkdev[256];
+
+  for (dev = 0; dev < MAXDEV; dev++)
+    {
+      sprintf (devname, "/dev/dsp%d", dev);
+      if (lstat (devname, &st) != -1)
+	if (S_ISLNK (st.st_mode))
+	  {
+	    int l;
+
+	    if ((l = readlink (devname, linkdev, sizeof (linkdev) - 1)) == -1)
+	      {
+		continue;
+	      }
+	    else
+	      {
+		linkdev[l] = 0;
+		if (strcmp (linkdev, ai->devnode) == 0)	/* Match */
+		  {
+		    ai->legacy_device = dev;
+		    return dev;
+		  }
+	      }
+	  }
+    }
+
+  return -1;			/* Nothing found */
+}
+
+static void
+create_dsplinks (void)
+{
+  int dev, newdev, numfiles = 0, legacy_number = 0;
+  struct stat st;
+  char devname[64];
+
+  oss_audioinfo *ai, *audiodevs[MAXDEV];
+
+  oss_renumber_t renum = { 0 };
+
+  if (recreate_all)
+    {
+      if ((unlink ("/dev/dsp") == -1) && (errno != ENOENT))
+	fprintf (stderr, "Couldn't remove /dev/dsp link!\n");
+      remove_nodes ("/dev", "dsp[0-9]*");
+      remove_nodes ("/dev", "dsp_*");
+    }
+
+  if (verbose) printf ("%d audio devices\n", si.numaudios);
+
+  if (si.numaudios < 1)
+    return;
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      ai = malloc (sizeof (*ai));
+
+      ai->dev = dev;
+
+      if (ioctl (mixerfd, SNDCTL_AUDIOINFO, ai) == -1)
+	{
+	  perror ("SNDCTL_AUDIOINFO");
+	  exit (-1);
+	}
+
+      audiodevs[dev] = ai;
+
+      /* if (verbose) printf ("Adev %d = %s\n", dev, ai->devnode); */
+    }
+
+  for (dev = 0; dev < MAXDEV; dev++)
+    {
+
+      sprintf (devname, "/dev/dsp%d", dev);
+      newdev = dev;
+
+      if (lstat (devname, &st) != -1)
+	{
+	  if (S_ISLNK (st.st_mode))
+	    numfiles = dev + 1;
+	}
+    }
+
+  if (verbose) printf ("/dev/dsp%d is the next free legacy device\n", numfiles);
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      int recreate = 0;
+#ifdef VDEV_SUPPORT
+      if (audiodevs[dev]->caps & PCM_CAP_HIDDEN)	/* Ignore hidden devices */
+	{
+	  audiodevs[dev]->legacy_device = -1;
+	  continue;
+	}
+#endif
+
+      newdev = legacy_number++;
+      sprintf (devname, "/dev/dsp%d", newdev);
+
+      if (lstat (devname, &st) == -1)
+	{
+	  if (verbose) printf ("%s: %s\n", devname, strerror (errno));
+	  recreate = 1;
+	}
+      else
+	{
+	  if (S_ISCHR (st.st_mode))
+	    {
+	      if (verbose) printf ("%s: character device\n", devname);
+	      recreate = 1;
+	    }
+	  else if (S_ISLNK (st.st_mode))
+	    {
+	      int l;
+
+	      char linkdev[256];
+	      if ((l =
+		   readlink (devname, linkdev, sizeof (linkdev) - 1)) == -1)
+		{
+		  perror ("readlink");
+		  strcpy (linkdev, "Invalid");
+		}
+	      else
+		{
+		  linkdev[l] = 0;
+		}
+
+	      if (verbose) printf ("%s: symlink -> %s ", devname, linkdev);
+
+	      if (strcmp (linkdev, audiodevs[dev]->devnode) != 0)
+		{
+		  if (verbose) printf ("(should be %s)\n",
+				       audiodevs[dev]->devnode);
+		  if ((newdev = find_dsplink (audiodevs[dev])) == -1)
+		    {
+		      recreate = 1;
+		      newdev = numfiles++;
+		    }
+		  else
+		    if (verbose) printf ("\tAlready linked to /dev/dsp%d\n",
+					 newdev);
+		}
+	      else
+		if (verbose) printf ("OK\n");
+	    }
+	  else
+	    {
+	      if (verbose) printf ("%s: unknown file type\n", devname);
+	      recreate = 1;
+	    }
+
+	}
+
+      if (recreate)
+	{
+	  audiodevs[dev]->legacy_device = newdev;
+	  sprintf (devname, "/dev/dsp%d", newdev);
+
+	  if (strcmp (audiodevs[dev]->devnode, devname) != 0)	/* Not the same */
+	    {
+	      unlink (devname);
+	      if (symlink (audiodevs[dev]->devnode, devname) == -1)
+		{
+		  perror ("symlink");
+		  fprintf (stderr, "Cannot create link %s->%s\n", devname,
+			   audiodevs[dev]->devnode);
+		  exit (-1);
+		}
+
+	      if (verbose) printf ("Created new legacy device %s -> %s\n",
+				   devname, audiodevs[dev]->devnode);
+	      audiodevs[dev]->legacy_device = newdev;
+	    }
+	}
+    }
+
+  if (verbose) printf ("%d legacy dsp device files\n", numfiles);
+
+  renum.n = si.numaudios;
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      if (audiodevs[dev]->legacy_device != dev)
+	if (audiodevs[dev]->legacy_device >= 0)
+	  if (verbose) printf ("Adev %d (%s) is legacy device file "
+			       "/dev/dsp%d\n", dev, audiodevs[dev]->devnode,
+			       audiodevs[dev]->legacy_device);
+
+      renum.map[dev] = audiodevs[dev]->legacy_device;
+    }
+
+  if (ioctl (mixerfd, OSSCTL_RENUM_AUDIODEVS, &renum) == -1)
+    {
+      perror ("audio_renum");
+    }
+
+
+/*
+ * Find out a suitable /dev/dsp device (input and output capable).
+ * Remove old /dev/dsp if it appears to be a character device node.
+ */
+  if (lstat ("/dev/dsp", &st) != -1)
+    if (S_ISCHR (st.st_mode))
+      unlink ("/dev/dsp");
+
+/*
+ * Remove /dev/dsp link that points to some bogus device. This may
+ * happen if some hot-pluggable (USB) device has been
+ * removed from the system.
+ */
+  if (lstat ("/dev/dsp", &st) != -1)	/* /dev/dsp exists (and is symlink) */
+    if (stat ("/dev/dsp", &st) == -1)	/* But points to nowhere */
+      unlink ("/dev/dsp");
+
+/*
+ * Next find a duplex capable audio device.
+ */
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      ai = audiodevs[dev];
+
+      if (!(ai->caps & PCM_CAP_OUTPUT))
+	continue;
+
+      if (!(ai->caps & PCM_CAP_INPUT))
+	continue;
+
+      if (ai->min_channels > 2 || ai->max_channels < 2) /* No stereo */
+	 continue;
+
+      if (verbose) printf ("%s is the default /dev/dsp device\n", ai->devnode);
+      err = symlink (ai->devnode, "/dev/dsp");	/* Ignore errors */
+      break;
+    }
+
+/*
+ * Find out a suitable /dev/dsp_out device.
+ */
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      ai = audiodevs[dev];
+
+      if (!(ai->caps & PCM_CAP_OUTPUT))
+	continue;
+
+      if (verbose) printf ("%s is the default dsp_out device\n", ai->devnode);
+      err = symlink (ai->devnode, "/dev/dsp_out");	/* Ignore errors */
+
+      /*
+       * Also link /dev/dsp just in case the link doesn't
+       * exist yet.
+       */
+      err = symlink (ai->devnode, "/dev/dsp");	/* Ignore errors */
+      break;
+    }
+
+/*
+ * Find out a suitable /dev/dsp_in device.
+ */
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      ai = audiodevs[dev];
+
+      if (!(ai->caps & PCM_CAP_INPUT))
+	continue;
+
+      if (verbose) printf ("%s is the default dsp_in device\n", ai->devnode);
+      err = symlink (ai->devnode, "/dev/dsp_in");	/* Ignore errors */
+
+      /*
+       * Also link /dev/dsp just in case the link doesn't
+       * exist yet.
+       */
+      err = symlink (ai->devnode, "/dev/dsp");	/* Ignore errors */
+      break;
+    }
+
+/*
+ * Find out a suitable /dev/dsp_ac3 output device.
+ */
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      ai = audiodevs[dev];
+
+      if (!(ai->caps & PCM_CAP_OUTPUT))
+	continue;
+
+      if (!(ai->oformats & AFMT_AC3))
+	continue;
+
+      if (verbose) printf ("%s is the default AC3 output device\n",
+			   ai->devnode);
+      err = symlink (ai->devnode, "/dev/dsp_ac3");	/* Ignore errors */
+      break;
+    }
+
+/*
+ * Find out a suitable /dev/dsp_mmap output device.
+ */
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      ai = audiodevs[dev];
+
+      if (!(ai->caps & PCM_CAP_OUTPUT))
+	continue;
+
+      if (!(ai->caps & PCM_CAP_MMAP))
+	continue;
+
+      if (!(ai->caps & PCM_CAP_TRIGGER))
+	continue;
+
+      if (ai->max_channels < 2)
+	continue;
+
+      if (ai->min_channels > 2)
+	continue;
+
+      if (verbose) printf ("%s is the default mmap output device\n",
+			   ai->devnode);
+      err = symlink (ai->devnode, "/dev/dsp_mmap");	/* Ignore errors */
+      break;
+    }
+
+/*
+ * Find out a suitable /dev/dsp_multich output device.
+ */
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      ai = audiodevs[dev];
+
+      if (!(ai->caps & PCM_CAP_OUTPUT))
+	continue;
+
+      if (ai->max_channels < 4)
+	continue;
+
+      if (verbose) printf ("%s is the default multichan output device\n",
+			   ai->devnode);
+      err = symlink (ai->devnode, "/dev/dsp_multich");	/* Ignore errors */
+      break;
+    }
+
+/*
+ * Find out a suitable /dev/dsp_spdifout output device.
+ */
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      ai = audiodevs[dev];
+
+      if (!(ai->caps & PCM_CAP_OUTPUT))
+	continue;
+
+      if (!(ai->caps & PCM_CAP_DIGITALOUT))
+	continue;
+
+      if (verbose) printf ("%s is the default S/PDIF digital output device\n",
+			   ai->devnode);
+      err = symlink (ai->devnode, "/dev/dsp_spdifout");	/* Ignore errors */
+      break;
+    }
+
+/*
+ * Find out a suitable /dev/dsp_spdifin input device.
+ */
+
+  for (dev = 0; dev < si.numaudios; dev++)
+    {
+      ai = audiodevs[dev];
+
+      if (!(ai->caps & PCM_CAP_INPUT))
+	continue;
+
+      if (!(ai->caps & PCM_CAP_DIGITALIN))
+	continue;
+
+      if (verbose) printf ("%s is the default S/PDIF digital input device\n",
+			   ai->devnode);
+      err = symlink (ai->devnode, "/dev/dsp_spdifin");	/* Ignore errors */
+      break;
+    }
+}
+
+/*
+ *****************************
+ * /dev/mixer handling
+ */
+
+static int
+find_mixerlink (oss_mixerinfo * xi)
+{
+  int dev;
+/*
+ * Look for a legacy (/dev/mixer#) devife file that is a symlink to
+ * xi->devnode. Return the device number if a
+ * matching link is found. Return -1 if nothing is found.
+ */
+
+  struct stat st;
+  char devname[64], linkdev[256];
+
+  for (dev = 0; dev < MAXDEV; dev++)
+    {
+      sprintf (devname, "/dev/mixer%d", dev);
+      if (lstat (devname, &st) != -1)
+	if (S_ISLNK (st.st_mode))
+	  {
+	    int l;
+
+	    if ((l = readlink (devname, linkdev, sizeof (linkdev) - 1)) == -1)
+	      {
+		continue;
+	      }
+	    else
+	      {
+		linkdev[l] = 0;
+		if (strcmp (linkdev, xi->devnode) == 0)	/* Match */
+		  {
+		    xi->legacy_device = dev;
+		    return dev;
+		  }
+	      }
+	  }
+    }
+
+  return -1;			/* Nothing found */
+}
+
+static void
+create_mixerlinks (void)
+{
+  int dev, newdev, numfiles = 0;
+  struct stat st;
+  char devname[64];
+
+  oss_mixerinfo *xi, *mixerdevs[MAXDEV];
+
+  oss_renumber_t renum = { 0 };
+
+  if (recreate_all)
+    remove_nodes ("/dev", "mixer[0-9]*");
+
+  if (verbose) printf ("%d mixer devices\n", si.nummixers);
+
+  if (si.nummixers < 1)
+    return;
+
+  for (dev = 0; dev < si.nummixers; dev++)
+    {
+      xi = malloc (sizeof (*xi));
+
+      xi->dev = dev;
+
+      if (ioctl (mixerfd, SNDCTL_MIXERINFO, xi) == -1)
+	{
+	  perror ("SNDCTL_MIXERINFO");
+	  exit (-1);
+	}
+
+      mixerdevs[dev] = xi;
+
+      /* if (verbose) printf ("Mixdev %d = %s\n", dev, xi->devnode); */
+    }
+
+  for (dev = 0; dev < MAXDEV; dev++)
+    {
+
+      sprintf (devname, "/dev/mixer%d", dev);
+      newdev = dev;
+
+      if (lstat (devname, &st) != -1)
+	{
+	  if (S_ISLNK (st.st_mode))
+	    numfiles = dev + 1;
+	}
+    }
+
+  if (numfiles < si.nummixers)
+    numfiles = si.nummixers;
+
+  if (verbose) printf ("/dev/mixer%d is the next free legacy device\n",
+		       numfiles);
+
+  for (dev = 0; dev < si.nummixers; dev++)
+    {
+      int recreate = 0;
+
+      sprintf (devname, "/dev/mixer%d", dev);
+      newdev = dev;
+
+      if (lstat (devname, &st) == -1)
+	{
+	  if (verbose) printf ("%s: %s\n", devname, strerror (errno));
+	  recreate = 1;
+	}
+      else
+	{
+	  if (S_ISCHR (st.st_mode))
+	    {
+	      if (verbose) printf ("%s: character device\n", devname);
+	      recreate = 1;
+	    }
+	  else if (S_ISLNK (st.st_mode))
+	    {
+	      int l;
+
+	      char linkdev[256];
+	      if ((l =
+		   readlink (devname, linkdev, sizeof (linkdev) - 1)) == -1)
+		{
+		  perror ("readlink");
+		  strcpy (linkdev, "Invalid");
+		}
+	      else
+		{
+		  linkdev[l] = 0;
+		}
+
+	      if (verbose) printf ("%s: symlink -> %s ", devname, linkdev);
+
+	      if (strcmp (linkdev, mixerdevs[dev]->devnode) != 0)
+		{
+		  if (verbose) printf ("(should be %s)\n",
+				       mixerdevs[dev]->devnode);
+		  if ((newdev = find_mixerlink (mixerdevs[dev])) == -1)
+		    {
+		      recreate = 1;
+		      newdev = numfiles++;
+		    }
+		  else
+		    if (verbose) printf ("\tAlready linked to /dev/mixer%d\n",
+					 newdev);
+		}
+	      else
+		if (verbose) printf ("OK\n");
+	    }
+	  else
+	    {
+	      if (verbose) printf ("%s: unknown file type\n", devname);
+	      recreate = 1;
+	    }
+
+	}
+
+      if (recreate)
+	{
+	  mixerdevs[dev]->legacy_device = newdev;
+	  sprintf (devname, "/dev/mixer%d", newdev);
+
+	  if (strcmp (mixerdevs[dev]->devnode, devname) != 0)	/* Not the same */
+	    {
+	      unlink (devname);
+	      if (symlink (mixerdevs[dev]->devnode, devname) == -1)
+		{
+		  perror ("symlink");
+		  fprintf (stderr, "Cannot create link %s->%s\n", devname,
+			   mixerdevs[dev]->devnode);
+		  exit (-1);
+		}
+
+	      if (verbose) printf ("Created new legacy device %s -> %s\n",
+				   devname, mixerdevs[dev]->devnode);
+	    }
+	}
+    }
+
+  if (verbose) printf ("%d legacy mixer device files\n", numfiles);
+
+  renum.n = si.nummixers;
+
+  for (dev = 0; dev < si.nummixers; dev++)
+    {
+      if (mixerdevs[dev]->legacy_device != dev)
+	if (verbose) printf ("Mixdev %d is legacy device file /dev/mixer%d\n",
+			     dev, mixerdevs[dev]->legacy_device);
+      renum.map[dev] = mixerdevs[dev]->legacy_device;
+    }
+
+  if (ioctl (mixerfd, OSSCTL_RENUM_MIXERDEVS, &renum) == -1)
+    {
+      perror ("mixer_renum");
+    }
+}
+
+#ifdef CONFIG_OSS_MIDI
+/*
+ * MIDI devices (/dev/midiNN)
+ */
+
+static int
+find_midilink (oss_midi_info * xi)
+{
+  int dev;
+/*
+ * Look for a legacy (/dev/midi#) devife file that is a symlink to
+ * xi->devnode. Return the device number if a
+ * matching link is found. Return -1 if nothing is found.
+ */
+
+  struct stat st;
+  char devname[64], linkdev[256];
+
+  for (dev = 0; dev < MAXDEV; dev++)
+    {
+      sprintf (devname, "/dev/midi%02d", dev);
+      if (lstat (devname, &st) != -1)
+	if (S_ISLNK (st.st_mode))
+	  {
+	    int l;
+
+	    if ((l = readlink (devname, linkdev, sizeof (linkdev) - 1)) == -1)
+	      {
+		continue;
+	      }
+	    else
+	      {
+		linkdev[l] = 0;
+		if (strcmp (linkdev, xi->devnode) == 0)	/* Match */
+		  {
+		    xi->legacy_device = dev;
+		    return dev;
+		  }
+	      }
+	  }
+    }
+
+  return -1;			/* Nothing found */
+}
+
+static void
+create_midilinks (void)
+{
+  int dev, newdev, numfiles = 0;
+  struct stat st;
+  char devname[64];
+
+  oss_midi_info *xi, *mididevs[MAXDEV];
+
+  oss_renumber_t renum = { 0 };
+
+  if (recreate_all)
+    remove_nodes ("/dev", "midi[0-9]*");
+
+  if (si.nummidis < 1)		/* No MIDI devices in the system */
+    return;
+
+  if (verbose) printf ("%d midi devices\n", si.nummidis);
+  for (dev = 0; dev < si.nummidis; dev++)
+    {
+      xi = malloc (sizeof (*xi));
+
+      xi->dev = dev;
+
+      if (ioctl (mixerfd, SNDCTL_MIDIINFO, xi) == -1)
+	{
+	  perror ("SNDCTL_MIDIINFO");
+	  exit (-1);
+	}
+
+      mididevs[dev] = xi;
+
+      /* if (verbose) printf ("Mididev %d = %s\n", dev, xi->devnode); */
+    }
+
+  for (dev = 0; dev < MAXDEV; dev++)
+    {
+
+      sprintf (devname, "/dev/midi%02d", dev);
+      newdev = dev;
+
+      if (lstat (devname, &st) != -1)
+	{
+	  if (S_ISLNK (st.st_mode))
+	    numfiles = dev + 1;
+	}
+    }
+
+  if (numfiles < si.nummidis)
+    numfiles = si.nummidis;
+
+  if (verbose) printf ("/dev/midi%02d is the next free legacy device\n",numfiles);
+
+  for (dev = 0; dev < si.nummidis; dev++)
+    {
+      int recreate = 0;
+
+      sprintf (devname, "/dev/midi%02d", dev);
+      newdev = dev;
+
+      if (lstat (devname, &st) == -1)
+	{
+	  if (verbose) printf ("%s: %s\n", devname, strerror (errno));
+	  recreate = 1;
+	}
+      else
+	{
+	  if (S_ISCHR (st.st_mode))
+	    {
+	      if (verbose) printf ("%s: character device\n", devname);
+	      recreate = 1;
+	    }
+	  else if (S_ISLNK (st.st_mode))
+	    {
+	      int l;
+
+	      char linkdev[256];
+	      if ((l =
+		   readlink (devname, linkdev, sizeof (linkdev) - 1)) == -1)
+		{
+		  perror ("readlink");
+		  strcpy (linkdev, "Invalid");
+		}
+	      else
+		{
+		  linkdev[l] = 0;
+		}
+
+	      if (verbose) printf ("%s: symlink -> %s ", devname, linkdev);
+
+	      if (strcmp (linkdev, mididevs[dev]->devnode) != 0)
+		{
+		  if (verbose) printf ("(should be %s)\n",
+				       mididevs[dev]->devnode);
+		  if ((newdev = find_midilink (mididevs[dev])) == -1)
+		    {
+		      recreate = 1;
+		      newdev = numfiles++;
+		    }
+		  else
+		    if (verbose) printf ("\tAlready linked to /dev/midi%02d\n",
+					 newdev);
+		}
+	      else
+		if (verbose) printf ("OK\n");
+	    }
+	  else
+	    {
+	      if (verbose) printf ("%s: unknown file type\n", devname);
+	      recreate = 1;
+	    }
+
+	}
+
+      if (recreate)
+	{
+	  mididevs[dev]->legacy_device = newdev;
+	  sprintf (devname, "/dev/midi%02d", newdev);
+
+	  if (strcmp (mididevs[dev]->devnode, devname) != 0)	/* Not the same */
+	    {
+	      unlink (devname);
+	      if (symlink (mididevs[dev]->devnode, devname) == -1)
+		{
+		  perror ("symlink");
+		  fprintf (stderr, "Cannot create link %s->%s\n", devname,
+			   mididevs[dev]->devnode);
+		  exit (-1);
+		}
+
+	      if (verbose) printf ("Created new legacy device %s -> %s\n",
+				   devname, mididevs[dev]->devnode);
+	    }
+	}
+    }
+
+  if (verbose) printf ("%d legacy MIDI device files\n", numfiles);
+
+  renum.n = si.nummidis;
+
+  for (dev = 0; dev < si.nummidis; dev++)
+    {
+      if (mididevs[dev]->legacy_device != dev)
+	if (verbose) printf ("Mididev %d is legacy device file /dev/midi%02d\n",
+			     dev, mididevs[dev]->legacy_device);
+      renum.map[dev] = mididevs[dev]->legacy_device;
+    }
+
+  if (ioctl (mixerfd, OSSCTL_RENUM_MIDIDEVS, &renum) == -1)
+    {
+      perror ("midi_renum");
+    }
+}
+#endif
+
+static void
+save_link (FILE * f, char *devname)
+{
+  char linkname[256];
+  int l;
+
+  if ((l = readlink (devname, linkname, sizeof (linkname) - 1)) == -1)
+    return;
+  linkname[l] = 0;
+
+  fprintf (f, "rm -f %s;ln -sf %s %s\n", devname, linkname, devname);
+}
+
+static void
+save_links (void)
+{
+  FILE *f;
+  int i;
+  char devfile[32];
+
+  if (legacydev_file == NULL)
+    {
+      char lfile[PATH_MAX+20], * osslibdir;
+
+      osslibdir = get_mapname ();
+      snprintf (lfile, sizeof (lfile), "%s/%s", osslibdir, "etc/legacy_devices");
+      if ((f = fopen (lfile, "w")) == NULL)
+	{
+	  perror (lfile);
+	  return;
+	}
+    }
+  else if ((f = fopen (legacydev_file, "w")) == NULL)
+    {
+      perror (legacydev_file);
+      return;
+    }
+
+/*
+ * /dev/dsp#
+ */
+
+  for (i = 0; i < MAXDEV; i++)
+    {
+      sprintf (devfile, "/dev/dsp%d", i);
+      save_link (f, devfile);
+    }
+
+  save_link (f, "/dev/dsp");
+  save_link (f, "/dev/dsp_ac3");
+  save_link (f, "/dev/dsp_in");
+  save_link (f, "/dev/dsp_mmap");
+  save_link (f, "/dev/dsp_multich");
+  save_link (f, "/dev/dsp_out");
+  save_link (f, "/dev/dsp_spdifout");
+  save_link (f, "/dev/dsp_spdifin");
+
+/*
+ * /dev/mixer#
+ */
+
+  for (i = 0; i < MAXDEV; i++)
+    {
+      sprintf (devfile, "/dev/mixer%d", i);
+      save_link (f, devfile);
+    }
+
+#ifdef CONFIG_OSS_MIDI
+/*
+ * /dev/midi##
+ */
+
+  for (i = 0; i < MAXDEV; i++)
+    {
+      sprintf (devfile, "/dev/midi%02d", i);
+      save_link (f, devfile);
+    }
+#endif
+
+  fclose (f);
+}
+
+int
+main (int argc, char *argv[])
+{
+  int c;
+
+  if ((mixerfd = open ("/dev/mixer", O_RDWR, 0)) == -1)
+    {
+      perror ("/dev/mixer");
+      exit (-1);
+    }
+
+  if (ioctl (mixerfd, SNDCTL_SYSINFO, &si) == -1)
+    {
+      if (errno == ENXIO)
+	{
+	  fprintf (stderr,
+		   "OSS has not detected any supported sound hardware ");
+	  fprintf (stderr, "in your system.\n");
+	  exit (-1);
+	}
+      else
+	{
+	  perror ("SNDCTL_SYSINFO");
+	  if (errno == EINVAL)
+	    fprintf (stderr, "Error: OSS version 4.0 or later is required\n");
+	  exit (-1);
+	}
+    }
+
+  while ((c = getopt (argc, argv, "Nf:rv")) != EOF)
+  switch (c)
+    {
+    case 'f':
+      legacydev_file = optarg;
+      break;
+
+    case 'r':
+      recreate_all = 1;
+      break;
+
+    case 'v':
+      verbose++;
+      break;
+
+    case 'N':
+      no_links = 1;
+      break;
+    }
+
+  if (!no_links) {
+    create_dsplinks ();
+    create_mixerlinks ();
+#ifdef CONFIG_OSS_MIDI
+    create_midilinks ();
+#endif
+  }
+
+  close (mixerfd);
+
+  save_links ();
+
+  return 0;
+}
diff --git a/cmd/ossdevlinks/ossdevlinks.man b/cmd/ossdevlinks/ossdevlinks.man
new file mode 100644
index 0000000..9fb23f9
--- /dev/null
+++ b/cmd/ossdevlinks/ossdevlinks.man
@@ -0,0 +1,43 @@
+NAME
+ossdevlinks - Open Sound System legacy device management utility.
+
+SYNOPSIS
+ossdevlinks [-vr]
+
+DESCRIPTION
+The ossdevlinks utility creates and manages old style (legacy) device files
+for OSS audio, MIDI and mixer devices.
+
+In previous versioms OSS used "flat" device numbering for the device files
+(for example /dev/dsp0 to /dev/dspN). OSS version 4.0 and later uses different
+naming scheme. The ossdevlinks utility is used to manage the legacy device
+names as symbolic links to the new style devices.
+
+OPTIONS
+Normally ossdevlinks is used without command line arguments. However
+there are a few command line options.
+
+-f<name>	Write legacydev file to <fname>. 
+-N		Do not actually modify device files
+-r		Reset the legacy device numbering (do not use).
+-v		Verbose output
+
+The -r option may invalidate audio device selections in the setup files
+of various applications. This is considered highly undesirable. Applications
+using wrong audio devices may cause serious security and privacy problems.
+For this reason the -r option should never be used unless there are no other
+ways to recover from serious audio/sound related problems. After that users
+should review the audio settings of all the audio applications they are using.
+                
+SEE ALSO
+ossinfo(1)
+
+FILES
+/usr/sbin/ossdevlinks
+/usr/lib/oss/etc/legacy_devices
+/dev/dspN
+/dev/midiNN
+/dev/mixerN
+
+AUTHOR
+4Front Technologies