From 5abac676269642e3aec1a19493994a1b8b9fe1a7 Mon Sep 17 00:00:00 2001 From: Jaroslav Kysela Date: Thu, 13 Aug 1998 15:42:56 +0000 Subject: [PATCH] Initial revision --- CHANGELOG | 41 + COPYING | 481 +++++++++++ Makefile | 54 ++ Makefile.conf.in | 25 + configure | 1734 ++++++++++++++++++++++++++++++++++++++++ configure.in | 63 ++ doc/Makefile | 20 + doc/plan.txt | 47 ++ doc/soundapi-1.html | 34 + doc/soundapi-2.html | 44 + doc/soundapi-3.html | 159 ++++ doc/soundapi-4.html | 268 +++++++ doc/soundapi-5.html | 552 +++++++++++++ doc/soundapi.html | 52 ++ doc/soundapi.sgml | 956 ++++++++++++++++++++++ doc/soundapi.txt | 1230 ++++++++++++++++++++++++++++ include/Makefile | 10 + include/config.h | 7 + include/config.h.in | 6 + include/control.h | 28 + include/error.h | 17 + include/footer.h | 5 + include/header.h | 27 + include/local.h | 240 ++++++ include/mixer.h | 35 + include/pcm.h | 40 + include/soundlib.h | 161 ++++ include/version.h | 9 + include/version.h.in | 9 + install-sh | 250 ++++++ src/Makefile | 74 ++ src/control/Makefile | 42 + src/control/cards.c | 94 +++ src/control/control.c | 146 ++++ src/error.c | 42 + src/mixer/Makefile | 41 + src/mixer/mixer.c | 224 ++++++ src/pcm/Makefile | 40 + src/pcm/pcm.c | 265 ++++++ test/Makefile | 15 + test/control.c | 67 ++ test/mixer.c | 60 ++ utils/Makefile | 10 + utils/alsa-lib.spec | 77 ++ utils/alsa-lib.spec.in | 78 ++ utils/buildrpm | 35 + version | 1 + 47 files changed, 7915 insertions(+) create mode 100644 CHANGELOG create mode 100644 COPYING create mode 100644 Makefile create mode 100644 Makefile.conf.in create mode 100644 configure create mode 100644 configure.in create mode 100644 doc/Makefile create mode 100644 doc/plan.txt create mode 100644 doc/soundapi-1.html create mode 100644 doc/soundapi-2.html create mode 100644 doc/soundapi-3.html create mode 100644 doc/soundapi-4.html create mode 100644 doc/soundapi-5.html create mode 100644 doc/soundapi.html create mode 100644 doc/soundapi.sgml create mode 100644 doc/soundapi.txt create mode 100644 include/Makefile create mode 100644 include/config.h create mode 100644 include/config.h.in create mode 100644 include/control.h create mode 100644 include/error.h create mode 100644 include/footer.h create mode 100644 include/header.h create mode 100644 include/local.h create mode 100644 include/mixer.h create mode 100644 include/pcm.h create mode 100644 include/soundlib.h create mode 100644 include/version.h create mode 100644 include/version.h.in create mode 100644 install-sh create mode 100644 src/Makefile create mode 100644 src/control/Makefile create mode 100644 src/control/cards.c create mode 100644 src/control/control.c create mode 100644 src/error.c create mode 100644 src/mixer/Makefile create mode 100644 src/mixer/mixer.c create mode 100644 src/pcm/Makefile create mode 100644 src/pcm/pcm.c create mode 100644 test/Makefile create mode 100644 test/control.c create mode 100644 test/mixer.c create mode 100644 utils/Makefile create mode 100644 utils/alsa-lib.spec create mode 100644 utils/alsa-lib.spec.in create mode 100644 utils/buildrpm create mode 100644 version diff --git a/CHANGELOG b/CHANGELOG new file mode 100644 index 00000000..a5aec85f --- /dev/null +++ b/CHANGELOG @@ -0,0 +1,41 @@ +0.0.8 -> 0.0.9 + +* Makefile and configure.in changes + - added check for alsa driver package + - added spec file for RPM + +0.0.7 -> 0.0.8 + +* added LGPL notice to all source and header files + +0.0.6 -> 0.0.7 + +* added snd_cards_name function + +0.0.5 -> 0.0.6 + +* fixed SND_PCM_OPEN constants + +0.0.4 -> 0.0.5 + +* added snd_cards_mask function +* added info functions for pcm playback/record in control interface +* fixed Makefile bugs for shared library (added -fPIC) + +0.0.3 -> 0.0.4 + +* changed COPYING policy from GPL to LGPL +* fixed bug in snd_mixer_channel_read & write +* added mixer exact support +* added pcm time mode support +* 'make install' is now possible + +0.0.2 -> 0.0.3 + +* corrected documentation + +0.0.1 -> 0.0.2 + +* added file COPYING +* added documentation in sgml + plan.txt +* minor changes in API for MIXER & PCM diff --git a/COPYING b/COPYING new file mode 100644 index 00000000..eb685a5e --- /dev/null +++ b/COPYING @@ -0,0 +1,481 @@ + GNU LIBRARY GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1991 Free Software Foundation, Inc. + 675 Mass Ave, Cambridge, MA 02139, USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + +[This is the first released version of the library GPL. It is + numbered 2 because it goes with version 2 of the ordinary GPL.] + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +Licenses are intended to guarantee your freedom to share and change +free software--to make sure the software is free for all its users. + + This license, the Library General Public License, applies to some +specially designated Free Software Foundation software, and to any +other libraries whose authors decide to use it. You can use it for +your libraries, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if +you distribute copies of the library, or if you modify it. + + For example, if you distribute copies of the library, whether gratis +or for a fee, you must give the recipients all the rights that we gave +you. You must make sure that they, too, receive or can get the source +code. If you link a program with the library, you must provide +complete object files to the recipients so that they can relink them +with the library, after making changes to the library and recompiling +it. And you must show them these terms so they know their rights. + + Our method of protecting your rights has two steps: (1) copyright +the library, and (2) offer you this license which gives you legal +permission to copy, distribute and/or modify the library. + + Also, for each distributor's protection, we want to make certain +that everyone understands that there is no warranty for this free +library. If the library is modified by someone else and passed on, we +want its recipients to know that what they have is not the original +version, so that any problems introduced by others will not reflect on +the original authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that companies distributing free +software will individually obtain patent licenses, thus in effect +transforming the program into proprietary software. To prevent this, +we have made it clear that any patent must be licensed for everyone's +free use or not licensed at all. + + Most GNU software, including some libraries, is covered by the ordinary +GNU General Public License, which was designed for utility programs. This +license, the GNU Library General Public License, applies to certain +designated libraries. This license is quite different from the ordinary +one; be sure to read it in full, and don't assume that anything in it is +the same as in the ordinary license. + + The reason we have a separate public license for some libraries is that +they blur the distinction we usually make between modifying or adding to a +program and simply using it. Linking a program with a library, without +changing the library, is in some sense simply using the library, and is +analogous to running a utility program or application program. However, in +a textual and legal sense, the linked executable is a combined work, a +derivative of the original library, and the ordinary General Public License +treats it as such. + + Because of this blurred distinction, using the ordinary General +Public License for libraries did not effectively promote software +sharing, because most developers did not use the libraries. We +concluded that weaker conditions might promote sharing better. + + However, unrestricted linking of non-free programs would deprive the +users of those programs of all benefit from the free status of the +libraries themselves. This Library General Public License is intended to +permit developers of non-free programs to use free libraries, while +preserving your freedom as a user of such programs to change the free +libraries that are incorporated in them. (We have not seen how to achieve +this as regards changes in header files, but we have achieved it as regards +changes in the actual functions of the Library.) The hope is that this +will lead to faster development of free libraries. + + The precise terms and conditions for copying, distribution and +modification follow. Pay close attention to the difference between a +"work based on the library" and a "work that uses the library". The +former contains code derived from the library, while the latter only +works together with the library. + + Note that it is possible for a library to be covered by the ordinary +General Public License rather than by this special one. + + GNU LIBRARY GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License Agreement applies to any software library which +contains a notice placed by the copyright holder or other authorized +party saying it may be distributed under the terms of this Library +General Public License (also called "this License"). Each licensee is +addressed as "you". + + A "library" means a collection of software functions and/or data +prepared so as to be conveniently linked with application programs +(which use some of those functions and data) to form executables. + + The "Library", below, refers to any such software library or work +which has been distributed under these terms. A "work based on the +Library" means either the Library or any derivative work under +copyright law: that is to say, a work containing the Library or a +portion of it, either verbatim or with modifications and/or translated +straightforwardly into another language. (Hereinafter, translation is +included without limitation in the term "modification".) + + "Source code" for a work means the preferred form of the work for +making modifications to it. For a library, complete source code means +all the source code for all modules it contains, plus any associated +interface definition files, plus the scripts used to control compilation +and installation of the library. + + Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running a program using the Library is not restricted, and output from +such a program is covered only if its contents constitute a work based +on the Library (independent of the use of the Library in a tool for +writing it). Whether that is true depends on what the Library does +and what the program that uses the Library does. + + 1. You may copy and distribute verbatim copies of the Library's +complete source code as you receive it, in any medium, provided that +you conspicuously and appropriately publish on each copy an +appropriate copyright notice and disclaimer of warranty; keep intact +all the notices that refer to this License and to the absence of any +warranty; and distribute a copy of this License along with the +Library. + + You may charge a fee for the physical act of transferring a copy, +and you may at your option offer warranty protection in exchange for a +fee. + + 2. You may modify your copy or copies of the Library or any portion +of it, thus forming a work based on the Library, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) The modified work must itself be a software library. + + b) You must cause the files modified to carry prominent notices + stating that you changed the files and the date of any change. + + c) You must cause the whole of the work to be licensed at no + charge to all third parties under the terms of this License. + + d) If a facility in the modified Library refers to a function or a + table of data to be supplied by an application program that uses + the facility, other than as an argument passed when the facility + is invoked, then you must make a good faith effort to ensure that, + in the event an application does not supply such function or + table, the facility still operates, and performs whatever part of + its purpose remains meaningful. + + (For example, a function in a library to compute square roots has + a purpose that is entirely well-defined independent of the + application. Therefore, Subsection 2d requires that any + application-supplied function or table used by this function must + be optional: if the application does not supply it, the square + root function must still compute square roots.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Library, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Library, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote +it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Library. + +In addition, mere aggregation of another work not based on the Library +with the Library (or with a work based on the Library) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may opt to apply the terms of the ordinary GNU General Public +License instead of this License to a given copy of the Library. To do +this, you must alter all the notices that refer to this License, so +that they refer to the ordinary GNU General Public License, version 2, +instead of to this License. (If a newer version than version 2 of the +ordinary GNU General Public License has appeared, then you can specify +that version instead if you wish.) Do not make any other change in +these notices. + + Once this change is made in a given copy, it is irreversible for +that copy, so the ordinary GNU General Public License applies to all +subsequent copies and derivative works made from that copy. + + This option is useful when you wish to copy part of the code of +the Library into a program that is not a library. + + 4. You may copy and distribute the Library (or a portion or +derivative of it, under Section 2) in object code or executable form +under the terms of Sections 1 and 2 above provided that you accompany +it with the complete corresponding machine-readable source code, which +must be distributed under the terms of Sections 1 and 2 above on a +medium customarily used for software interchange. + + If distribution of object code is made by offering access to copy +from a designated place, then offering equivalent access to copy the +source code from the same place satisfies the requirement to +distribute the source code, even though third parties are not +compelled to copy the source along with the object code. + + 5. A program that contains no derivative of any portion of the +Library, but is designed to work with the Library by being compiled or +linked with it, is called a "work that uses the Library". Such a +work, in isolation, is not a derivative work of the Library, and +therefore falls outside the scope of this License. + + However, linking a "work that uses the Library" with the Library +creates an executable that is a derivative of the Library (because it +contains portions of the Library), rather than a "work that uses the +library". The executable is therefore covered by this License. +Section 6 states terms for distribution of such executables. + + When a "work that uses the Library" uses material from a header file +that is part of the Library, the object code for the work may be a +derivative work of the Library even though the source code is not. +Whether this is true is especially significant if the work can be +linked without the Library, or if the work is itself a library. The +threshold for this to be true is not precisely defined by law. + + If such an object file uses only numerical parameters, data +structure layouts and accessors, and small macros and small inline +functions (ten lines or less in length), then the use of the object +file is unrestricted, regardless of whether it is legally a derivative +work. (Executables containing this object code plus portions of the +Library will still fall under Section 6.) + + Otherwise, if the work is a derivative of the Library, you may +distribute the object code for the work under the terms of Section 6. +Any executables containing that work also fall under Section 6, +whether or not they are linked directly with the Library itself. + + 6. As an exception to the Sections above, you may also compile or +link a "work that uses the Library" with the Library to produce a +work containing portions of the Library, and distribute that work +under terms of your choice, provided that the terms permit +modification of the work for the customer's own use and reverse +engineering for debugging such modifications. + + You must give prominent notice with each copy of the work that the +Library is used in it and that the Library and its use are covered by +this License. You must supply a copy of this License. If the work +during execution displays copyright notices, you must include the +copyright notice for the Library among them, as well as a reference +directing the user to the copy of this License. Also, you must do one +of these things: + + a) Accompany the work with the complete corresponding + machine-readable source code for the Library including whatever + changes were used in the work (which must be distributed under + Sections 1 and 2 above); and, if the work is an executable linked + with the Library, with the complete machine-readable "work that + uses the Library", as object code and/or source code, so that the + user can modify the Library and then relink to produce a modified + executable containing the modified Library. (It is understood + that the user who changes the contents of definitions files in the + Library will not necessarily be able to recompile the application + to use the modified definitions.) + + b) Accompany the work with a written offer, valid for at + least three years, to give the same user the materials + specified in Subsection 6a, above, for a charge no more + than the cost of performing this distribution. + + c) If distribution of the work is made by offering access to copy + from a designated place, offer equivalent access to copy the above + specified materials from the same place. + + d) Verify that the user has already received a copy of these + materials or that you have already sent this user a copy. + + For an executable, the required form of the "work that uses the +Library" must include any data and utility programs needed for +reproducing the executable from it. However, as a special exception, +the source code distributed need not include anything that is normally +distributed (in either source or binary form) with the major +components (compiler, kernel, and so on) of the operating system on +which the executable runs, unless that component itself accompanies +the executable. + + It may happen that this requirement contradicts the license +restrictions of other proprietary libraries that do not normally +accompany the operating system. Such a contradiction means you cannot +use both them and the Library together in an executable that you +distribute. + + 7. You may place library facilities that are a work based on the +Library side-by-side in a single library together with other library +facilities not covered by this License, and distribute such a combined +library, provided that the separate distribution of the work based on +the Library and of the other library facilities is otherwise +permitted, and provided that you do these two things: + + a) Accompany the combined library with a copy of the same work + based on the Library, uncombined with any other library + facilities. This must be distributed under the terms of the + Sections above. + + b) Give prominent notice with the combined library of the fact + that part of it is a work based on the Library, and explaining + where to find the accompanying uncombined form of the same work. + + 8. You may not copy, modify, sublicense, link with, or distribute +the Library except as expressly provided under this License. Any +attempt otherwise to copy, modify, sublicense, link with, or +distribute the Library is void, and will automatically terminate your +rights under this License. However, parties who have received copies, +or rights, from you under this License will not have their licenses +terminated so long as such parties remain in full compliance. + + 9. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Library or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Library (or any work based on the +Library), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Library or works based on it. + + 10. Each time you redistribute the Library (or any work based on the +Library), the recipient automatically receives a license from the +original licensor to copy, distribute, link with or modify the Library +subject to these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 11. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Library at all. For example, if a patent +license would not permit royalty-free redistribution of the Library by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Library. + +If any portion of this section is held invalid or unenforceable under any +particular circumstance, the balance of the section is intended to apply, +and the section as a whole is intended to apply in other circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 12. If the distribution and/or use of the Library is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Library under this License may add +an explicit geographical distribution limitation excluding those countries, +so that distribution is permitted only in or among countries not thus +excluded. In such case, this License incorporates the limitation as if +written in the body of this License. + + 13. The Free Software Foundation may publish revised and/or new +versions of the Library General Public License from time to time. +Such new versions will be similar in spirit to the present version, +but may differ in detail to address new problems or concerns. + +Each version is given a distinguishing version number. If the Library +specifies a version number of this License which applies to it and +"any later version", you have the option of following the terms and +conditions either of that version or of any later version published by +the Free Software Foundation. If the Library does not specify a +license version number, you may choose any version ever published by +the Free Software Foundation. + + 14. If you wish to incorporate parts of the Library into other free +programs whose distribution conditions are incompatible with these, +write to the author to ask for permission. For software which is +copyrighted by the Free Software Foundation, write to the Free +Software Foundation; we sometimes make exceptions for this. Our +decision will be guided by the two goals of preserving the free status +of all derivatives of our free software and of promoting the sharing +and reuse of software generally. + + NO WARRANTY + + 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO +WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. +EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR +OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY +KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE +LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME +THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN +WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY +AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU +FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR +CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE +LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING +RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A +FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF +SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH +DAMAGES. + + END OF TERMS AND CONDITIONS + + Appendix: How to Apply These Terms to Your New Libraries + + If you develop a new library, and you want it to be of the greatest +possible use to the public, we recommend making it free software that +everyone can redistribute and change. You can do so by permitting +redistribution under these terms (or, alternatively, under the terms of the +ordinary General Public License). + + To apply these terms, attach the following notices to the library. It is +safest to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least the +"copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public + License along with this library; if not, write to the Free + Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + +Also add information on how to contact you by electronic and paper mail. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the library, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the + library `Frob' (a library for tweaking knobs) written by James Random Hacker. + + , 1 April 1990 + Ty Coon, President of Vice + +That's all there is to it! diff --git a/Makefile b/Makefile new file mode 100644 index 00000000..ab7aea04 --- /dev/null +++ b/Makefile @@ -0,0 +1,54 @@ +# +# Makefile for ALSA library +# Copyright (c) 1994-98 by Jaroslav Kysela +# + +ifeq (Makefile.conf,$(wildcard Makefile.conf)) +include Makefile.conf +else +dummy: + @echo + @echo "Please, run configure script as first..." + @echo +endif + + +all: include/soundlib.h + $(MAKE) -C src + $(MAKE) -C doc + @echo + @echo "ALSA library were sucessfully compiled." + @echo + +include/soundlib.h: include/header.h include/version.h include/error.h include/footer.h \ + include/control.h include/mixer.h include/pcm.h + cat include/header.h include/version.h include/error.h \ + include/control.h include/mixer.h \ + include/pcm.h \ + include/footer.h > include/soundlib.h + +install: all + $(INSTALL) -m 644 -o root -g root include/soundlib.h ${includedir}/sys + $(INSTALL) -m 644 -o root -g root lib/libsound.a ${libdir} + $(LN_S) -f libsound.so.${SND_LIB_VERSION} ${libdir}/libsound.so + $(LN_S) -f libsound.so.${SND_LIB_VERSION} ${libdir}/libsound.so.${SND_LIB_MAJOR} + $(INSTALL) -m 644 -o root -g root lib/libsound.so.${SND_LIB_VERSION} ${libdir} + /sbin/ldconfig + +clean: + $(MAKE) -C include clean + $(MAKE) -C src clean + $(MAKE) -C test clean + $(MAKE) -C doc clean + $(MAKE) -C utils clean + rm -f core .depend *.o *.orig *~ + rm -f `find . -name "out.txt"` + +pack: clean + rm -f config.cache config.log config.status Makefile.conf + chown -R root.root ../alsa-lib + tar cvz -C .. -f ../alsa-lib-$(SND_LIB_VERSION).tar.gz alsa-lib + +publish: pack + cat ../alsa-lib-$(SND_LIB_VERSION).tar.gz | \ + ssh -l root zarquon.jcu.cz /home/alsa/publishlib alsa-lib-$(SND_LIB_VERSION).tar.gz diff --git a/Makefile.conf.in b/Makefile.conf.in new file mode 100644 index 00000000..9c0b8f8d --- /dev/null +++ b/Makefile.conf.in @@ -0,0 +1,25 @@ +# +# Configuration Makefile for ALSA library +# Copyright (c) 1994-98 by Jaroslav Kysela +# + +srcdir=@srcdir@ +VPATH=@srcdir@ +prefix=@prefix@ +exec_prefix=@exec_prefix@ +includedir=@includedir@ +libdir=@libdir@ +c_opts=@CFLAGS@ +INSTALL=@INSTALL@ +SND_LIB_VERSION=@SND_LIB_VERSION@ +SND_LIB_MAJOR=@SND_LIB_MAJOR@ +SND_LIB_MINOR=@SND_LIB_MINOR@ +SND_LIB_SUBMINOR=@SND_LIB_SUBMINOR@ + +CC=@CC@ +CPP=@CPP@ +INCLUDE=-I../include -I../../include +COPTS = $(c_opts) +COPTS += -Wall -Wstrict-prototypes -fomit-frame-pointer -pipe +LINKER=ld +LN_S=@LN_S@ diff --git a/configure b/configure new file mode 100644 index 00000000..bc17bef4 --- /dev/null +++ b/configure @@ -0,0 +1,1734 @@ +#! /bin/sh + +# Guess values for system-dependent variables and create Makefiles. +# Generated automatically using autoconf version 2.12 +# Copyright (C) 1992, 93, 94, 95, 96 Free Software Foundation, Inc. +# +# This configure script is free software; the Free Software Foundation +# gives unlimited permission to copy, distribute and modify it. + +# Defaults: +ac_help= +ac_default_prefix=/usr/local +# Any additions from configure.in: +ac_default_prefix=/usr + +# Initialize some variables set by options. +# The variables have the same names as the options, with +# dashes changed to underlines. +build=NONE +cache_file=./config.cache +exec_prefix=NONE +host=NONE +no_create= +nonopt=NONE +no_recursion= +prefix=NONE +program_prefix=NONE +program_suffix=NONE +program_transform_name=s,x,x, +silent= +site= +srcdir= +target=NONE +verbose= +x_includes=NONE +x_libraries=NONE +bindir='${exec_prefix}/bin' +sbindir='${exec_prefix}/sbin' +libexecdir='${exec_prefix}/libexec' +datadir='${prefix}/share' +sysconfdir='${prefix}/etc' +sharedstatedir='${prefix}/com' +localstatedir='${prefix}/var' +libdir='${exec_prefix}/lib' +includedir='${prefix}/include' +oldincludedir='/usr/include' +infodir='${prefix}/info' +mandir='${prefix}/man' + +# Initialize some other variables. +subdirs= +MFLAGS= MAKEFLAGS= +# Maximum number of lines to put in a shell here document. +ac_max_here_lines=12 + +ac_prev= +for ac_option +do + + # If the previous option needs an argument, assign it. + if test -n "$ac_prev"; then + eval "$ac_prev=\$ac_option" + ac_prev= + continue + fi + + case "$ac_option" in + -*=*) ac_optarg=`echo "$ac_option" | sed 's/[-_a-zA-Z0-9]*=//'` ;; + *) ac_optarg= ;; + esac + + # Accept the important Cygnus configure options, so we can diagnose typos. + + case "$ac_option" in + + -bindir | --bindir | --bindi | --bind | --bin | --bi) + ac_prev=bindir ;; + -bindir=* | --bindir=* | --bindi=* | --bind=* | --bin=* | --bi=*) + bindir="$ac_optarg" ;; + + -build | --build | --buil | --bui | --bu) + ac_prev=build ;; + -build=* | --build=* | --buil=* | --bui=* | --bu=*) + build="$ac_optarg" ;; + + -cache-file | --cache-file | --cache-fil | --cache-fi \ + | --cache-f | --cache- | --cache | --cach | --cac | --ca | --c) + ac_prev=cache_file ;; + -cache-file=* | --cache-file=* | --cache-fil=* | --cache-fi=* \ + | --cache-f=* | --cache-=* | --cache=* | --cach=* | --cac=* | --ca=* | --c=*) + cache_file="$ac_optarg" ;; + + -datadir | --datadir | --datadi | --datad | --data | --dat | --da) + ac_prev=datadir ;; + -datadir=* | --datadir=* | --datadi=* | --datad=* | --data=* | --dat=* \ + | --da=*) + datadir="$ac_optarg" ;; + + -disable-* | --disable-*) + ac_feature=`echo $ac_option|sed -e 's/-*disable-//'` + # Reject names that are not valid shell variable names. + if test -n "`echo $ac_feature| sed 's/[-a-zA-Z0-9_]//g'`"; then + { echo "configure: error: $ac_feature: invalid feature name" 1>&2; exit 1; } + fi + ac_feature=`echo $ac_feature| sed 's/-/_/g'` + eval "enable_${ac_feature}=no" ;; + + -enable-* | --enable-*) + ac_feature=`echo $ac_option|sed -e 's/-*enable-//' -e 's/=.*//'` + # Reject names that are not valid shell variable names. + if test -n "`echo $ac_feature| sed 's/[-_a-zA-Z0-9]//g'`"; then + { echo "configure: error: $ac_feature: invalid feature name" 1>&2; exit 1; } + fi + ac_feature=`echo $ac_feature| sed 's/-/_/g'` + case "$ac_option" in + *=*) ;; + *) ac_optarg=yes ;; + esac + eval "enable_${ac_feature}='$ac_optarg'" ;; + + -exec-prefix | --exec_prefix | --exec-prefix | --exec-prefi \ + | --exec-pref | --exec-pre | --exec-pr | --exec-p | --exec- \ + | --exec | --exe | --ex) + ac_prev=exec_prefix ;; + -exec-prefix=* | --exec_prefix=* | --exec-prefix=* | --exec-prefi=* \ + | --exec-pref=* | --exec-pre=* | --exec-pr=* | --exec-p=* | --exec-=* \ + | --exec=* | --exe=* | --ex=*) + exec_prefix="$ac_optarg" ;; + + -gas | --gas | --ga | --g) + # Obsolete; use --with-gas. + with_gas=yes ;; + + -help | --help | --hel | --he) + # Omit some internal or obsolete options to make the list less imposing. + # This message is too long to be a string in the A/UX 3.1 sh. + cat << EOF +Usage: configure [options] [host] +Options: [defaults in brackets after descriptions] +Configuration: + --cache-file=FILE cache test results in FILE + --help print this message + --no-create do not create output files + --quiet, --silent do not print \`checking...' messages + --version print the version of autoconf that created configure +Directory and file names: + --prefix=PREFIX install architecture-independent files in PREFIX + [$ac_default_prefix] + --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX + [same as prefix] + --bindir=DIR user executables in DIR [EPREFIX/bin] + --sbindir=DIR system admin executables in DIR [EPREFIX/sbin] + --libexecdir=DIR program executables in DIR [EPREFIX/libexec] + --datadir=DIR read-only architecture-independent data in DIR + [PREFIX/share] + --sysconfdir=DIR read-only single-machine data in DIR [PREFIX/etc] + --sharedstatedir=DIR modifiable architecture-independent data in DIR + [PREFIX/com] + --localstatedir=DIR modifiable single-machine data in DIR [PREFIX/var] + --libdir=DIR object code libraries in DIR [EPREFIX/lib] + --includedir=DIR C header files in DIR [PREFIX/include] + --oldincludedir=DIR C header files for non-gcc in DIR [/usr/include] + --infodir=DIR info documentation in DIR [PREFIX/info] + --mandir=DIR man documentation in DIR [PREFIX/man] + --srcdir=DIR find the sources in DIR [configure dir or ..] + --program-prefix=PREFIX prepend PREFIX to installed program names + --program-suffix=SUFFIX append SUFFIX to installed program names + --program-transform-name=PROGRAM + run sed PROGRAM on installed program names +EOF + cat << EOF +Host type: + --build=BUILD configure for building on BUILD [BUILD=HOST] + --host=HOST configure for HOST [guessed] + --target=TARGET configure for TARGET [TARGET=HOST] +Features and packages: + --disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no) + --enable-FEATURE[=ARG] include FEATURE [ARG=yes] + --with-PACKAGE[=ARG] use PACKAGE [ARG=yes] + --without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no) + --x-includes=DIR X include files are in DIR + --x-libraries=DIR X library files are in DIR +EOF + if test -n "$ac_help"; then + echo "--enable and --with options recognized:$ac_help" + fi + exit 0 ;; + + -host | --host | --hos | --ho) + ac_prev=host ;; + -host=* | --host=* | --hos=* | --ho=*) + host="$ac_optarg" ;; + + -includedir | --includedir | --includedi | --included | --include \ + | --includ | --inclu | --incl | --inc) + ac_prev=includedir ;; + -includedir=* | --includedir=* | --includedi=* | --included=* | --include=* \ + | --includ=* | --inclu=* | --incl=* | --inc=*) + includedir="$ac_optarg" ;; + + -infodir | --infodir | --infodi | --infod | --info | --inf) + ac_prev=infodir ;; + -infodir=* | --infodir=* | --infodi=* | --infod=* | --info=* | --inf=*) + infodir="$ac_optarg" ;; + + -libdir | --libdir | --libdi | --libd) + ac_prev=libdir ;; + -libdir=* | --libdir=* | --libdi=* | --libd=*) + libdir="$ac_optarg" ;; + + -libexecdir | --libexecdir | --libexecdi | --libexecd | --libexec \ + | --libexe | --libex | --libe) + ac_prev=libexecdir ;; + -libexecdir=* | --libexecdir=* | --libexecdi=* | --libexecd=* | --libexec=* \ + | --libexe=* | --libex=* | --libe=*) + libexecdir="$ac_optarg" ;; + + -localstatedir | --localstatedir | --localstatedi | --localstated \ + | --localstate | --localstat | --localsta | --localst \ + | --locals | --local | --loca | --loc | --lo) + ac_prev=localstatedir ;; + -localstatedir=* | --localstatedir=* | --localstatedi=* | --localstated=* \ + | --localstate=* | --localstat=* | --localsta=* | --localst=* \ + | --locals=* | --local=* | --loca=* | --loc=* | --lo=*) + localstatedir="$ac_optarg" ;; + + -mandir | --mandir | --mandi | --mand | --man | --ma | --m) + ac_prev=mandir ;; + -mandir=* | --mandir=* | --mandi=* | --mand=* | --man=* | --ma=* | --m=*) + mandir="$ac_optarg" ;; + + -nfp | --nfp | --nf) + # Obsolete; use --without-fp. + with_fp=no ;; + + -no-create | --no-create | --no-creat | --no-crea | --no-cre \ + | --no-cr | --no-c) + no_create=yes ;; + + -no-recursion | --no-recursion | --no-recursio | --no-recursi \ + | --no-recurs | --no-recur | --no-recu | --no-rec | --no-re | --no-r) + no_recursion=yes ;; + + -oldincludedir | --oldincludedir | --oldincludedi | --oldincluded \ + | --oldinclude | --oldinclud | --oldinclu | --oldincl | --oldinc \ + | --oldin | --oldi | --old | --ol | --o) + ac_prev=oldincludedir ;; + -oldincludedir=* | --oldincludedir=* | --oldincludedi=* | --oldincluded=* \ + | --oldinclude=* | --oldinclud=* | --oldinclu=* | --oldincl=* | --oldinc=* \ + | --oldin=* | --oldi=* | --old=* | --ol=* | --o=*) + oldincludedir="$ac_optarg" ;; + + -prefix | --prefix | --prefi | --pref | --pre | --pr | --p) + ac_prev=prefix ;; + -prefix=* | --prefix=* | --prefi=* | --pref=* | --pre=* | --pr=* | --p=*) + prefix="$ac_optarg" ;; + + -program-prefix | --program-prefix | --program-prefi | --program-pref \ + | --program-pre | --program-pr | --program-p) + ac_prev=program_prefix ;; + -program-prefix=* | --program-prefix=* | --program-prefi=* \ + | --program-pref=* | --program-pre=* | --program-pr=* | --program-p=*) + program_prefix="$ac_optarg" ;; + + -program-suffix | --program-suffix | --program-suffi | --program-suff \ + | --program-suf | --program-su | --program-s) + ac_prev=program_suffix ;; + -program-suffix=* | --program-suffix=* | --program-suffi=* \ + | --program-suff=* | --program-suf=* | --program-su=* | --program-s=*) + program_suffix="$ac_optarg" ;; + + -program-transform-name | --program-transform-name \ + | --program-transform-nam | --program-transform-na \ + | --program-transform-n | --program-transform- \ + | --program-transform | --program-transfor \ + | --program-transfo | --program-transf \ + | --program-trans | --program-tran \ + | --progr-tra | --program-tr | --program-t) + ac_prev=program_transform_name ;; + -program-transform-name=* | --program-transform-name=* \ + | --program-transform-nam=* | --program-transform-na=* \ + | --program-transform-n=* | --program-transform-=* \ + | --program-transform=* | --program-transfor=* \ + | --program-transfo=* | --program-transf=* \ + | --program-trans=* | --program-tran=* \ + | --progr-tra=* | --program-tr=* | --program-t=*) + program_transform_name="$ac_optarg" ;; + + -q | -quiet | --quiet | --quie | --qui | --qu | --q \ + | -silent | --silent | --silen | --sile | --sil) + silent=yes ;; + + -sbindir | --sbindir | --sbindi | --sbind | --sbin | --sbi | --sb) + ac_prev=sbindir ;; + -sbindir=* | --sbindir=* | --sbindi=* | --sbind=* | --sbin=* \ + | --sbi=* | --sb=*) + sbindir="$ac_optarg" ;; + + -sharedstatedir | --sharedstatedir | --sharedstatedi \ + | --sharedstated | --sharedstate | --sharedstat | --sharedsta \ + | --sharedst | --shareds | --shared | --share | --shar \ + | --sha | --sh) + ac_prev=sharedstatedir ;; + -sharedstatedir=* | --sharedstatedir=* | --sharedstatedi=* \ + | --sharedstated=* | --sharedstate=* | --sharedstat=* | --sharedsta=* \ + | --sharedst=* | --shareds=* | --shared=* | --share=* | --shar=* \ + | --sha=* | --sh=*) + sharedstatedir="$ac_optarg" ;; + + -site | --site | --sit) + ac_prev=site ;; + -site=* | --site=* | --sit=*) + site="$ac_optarg" ;; + + -srcdir | --srcdir | --srcdi | --srcd | --src | --sr) + ac_prev=srcdir ;; + -srcdir=* | --srcdir=* | --srcdi=* | --srcd=* | --src=* | --sr=*) + srcdir="$ac_optarg" ;; + + -sysconfdir | --sysconfdir | --sysconfdi | --sysconfd | --sysconf \ + | --syscon | --sysco | --sysc | --sys | --sy) + ac_prev=sysconfdir ;; + -sysconfdir=* | --sysconfdir=* | --sysconfdi=* | --sysconfd=* | --sysconf=* \ + | --syscon=* | --sysco=* | --sysc=* | --sys=* | --sy=*) + sysconfdir="$ac_optarg" ;; + + -target | --target | --targe | --targ | --tar | --ta | --t) + ac_prev=target ;; + -target=* | --target=* | --targe=* | --targ=* | --tar=* | --ta=* | --t=*) + target="$ac_optarg" ;; + + -v | -verbose | --verbose | --verbos | --verbo | --verb) + verbose=yes ;; + + -version | --version | --versio | --versi | --vers) + echo "configure generated by autoconf version 2.12" + exit 0 ;; + + -with-* | --with-*) + ac_package=`echo $ac_option|sed -e 's/-*with-//' -e 's/=.*//'` + # Reject names that are not valid shell variable names. + if test -n "`echo $ac_package| sed 's/[-_a-zA-Z0-9]//g'`"; then + { echo "configure: error: $ac_package: invalid package name" 1>&2; exit 1; } + fi + ac_package=`echo $ac_package| sed 's/-/_/g'` + case "$ac_option" in + *=*) ;; + *) ac_optarg=yes ;; + esac + eval "with_${ac_package}='$ac_optarg'" ;; + + -without-* | --without-*) + ac_package=`echo $ac_option|sed -e 's/-*without-//'` + # Reject names that are not valid shell variable names. + if test -n "`echo $ac_package| sed 's/[-a-zA-Z0-9_]//g'`"; then + { echo "configure: error: $ac_package: invalid package name" 1>&2; exit 1; } + fi + ac_package=`echo $ac_package| sed 's/-/_/g'` + eval "with_${ac_package}=no" ;; + + --x) + # Obsolete; use --with-x. + with_x=yes ;; + + -x-includes | --x-includes | --x-include | --x-includ | --x-inclu \ + | --x-incl | --x-inc | --x-in | --x-i) + ac_prev=x_includes ;; + -x-includes=* | --x-includes=* | --x-include=* | --x-includ=* | --x-inclu=* \ + | --x-incl=* | --x-inc=* | --x-in=* | --x-i=*) + x_includes="$ac_optarg" ;; + + -x-libraries | --x-libraries | --x-librarie | --x-librari \ + | --x-librar | --x-libra | --x-libr | --x-lib | --x-li | --x-l) + ac_prev=x_libraries ;; + -x-libraries=* | --x-libraries=* | --x-librarie=* | --x-librari=* \ + | --x-librar=* | --x-libra=* | --x-libr=* | --x-lib=* | --x-li=* | --x-l=*) + x_libraries="$ac_optarg" ;; + + -*) { echo "configure: error: $ac_option: invalid option; use --help to show usage" 1>&2; exit 1; } + ;; + + *) + if test -n "`echo $ac_option| sed 's/[-a-z0-9.]//g'`"; then + echo "configure: warning: $ac_option: invalid host type" 1>&2 + fi + if test "x$nonopt" != xNONE; then + { echo "configure: error: can only configure for one host and one target at a time" 1>&2; exit 1; } + fi + nonopt="$ac_option" + ;; + + esac +done + +if test -n "$ac_prev"; then + { echo "configure: error: missing argument to --`echo $ac_prev | sed 's/_/-/g'`" 1>&2; exit 1; } +fi + +trap 'rm -fr conftest* confdefs* core core.* *.core $ac_clean_files; exit 1' 1 2 15 + +# File descriptor usage: +# 0 standard input +# 1 file creation +# 2 errors and warnings +# 3 some systems may open it to /dev/tty +# 4 used on the Kubota Titan +# 6 checking for... messages and results +# 5 compiler messages saved in config.log +if test "$silent" = yes; then + exec 6>/dev/null +else + exec 6>&1 +fi +exec 5>./config.log + +echo "\ +This file contains any messages produced by compilers while +running configure, to aid debugging if configure makes a mistake. +" 1>&5 + +# Strip out --no-create and --no-recursion so they do not pile up. +# Also quote any args containing shell metacharacters. +ac_configure_args= +for ac_arg +do + case "$ac_arg" in + -no-create | --no-create | --no-creat | --no-crea | --no-cre \ + | --no-cr | --no-c) ;; + -no-recursion | --no-recursion | --no-recursio | --no-recursi \ + | --no-recurs | --no-recur | --no-recu | --no-rec | --no-re | --no-r) ;; + *" "*|*" "*|*[\[\]\~\#\$\^\&\*\(\)\{\}\\\|\;\<\>\?]*) + ac_configure_args="$ac_configure_args '$ac_arg'" ;; + *) ac_configure_args="$ac_configure_args $ac_arg" ;; + esac +done + +# NLS nuisances. +# Only set these to C if already set. These must not be set unconditionally +# because not all systems understand e.g. LANG=C (notably SCO). +# Fixing LC_MESSAGES prevents Solaris sh from translating var values in `set'! +# Non-C LC_CTYPE values break the ctype check. +if test "${LANG+set}" = set; then LANG=C; export LANG; fi +if test "${LC_ALL+set}" = set; then LC_ALL=C; export LC_ALL; fi +if test "${LC_MESSAGES+set}" = set; then LC_MESSAGES=C; export LC_MESSAGES; fi +if test "${LC_CTYPE+set}" = set; then LC_CTYPE=C; export LC_CTYPE; fi + +# confdefs.h avoids OS command line length limits that DEFS can exceed. +rm -rf conftest* confdefs.h +# AIX cpp loses on an empty file, so make sure it contains at least a newline. +echo > confdefs.h + +# A filename unique to this package, relative to the directory that +# configure is in, which we can look for to find out if srcdir is correct. +ac_unique_file=Makefile.conf.in + +# Find the source files, if location was not specified. +if test -z "$srcdir"; then + ac_srcdir_defaulted=yes + # Try the directory containing this script, then its parent. + ac_prog=$0 + ac_confdir=`echo $ac_prog|sed 's%/[^/][^/]*$%%'` + test "x$ac_confdir" = "x$ac_prog" && ac_confdir=. + srcdir=$ac_confdir + if test ! -r $srcdir/$ac_unique_file; then + srcdir=.. + fi +else + ac_srcdir_defaulted=no +fi +if test ! -r $srcdir/$ac_unique_file; then + if test "$ac_srcdir_defaulted" = yes; then + { echo "configure: error: can not find sources in $ac_confdir or .." 1>&2; exit 1; } + else + { echo "configure: error: can not find sources in $srcdir" 1>&2; exit 1; } + fi +fi +srcdir=`echo "${srcdir}" | sed 's%\([^/]\)/*$%\1%'` + +# Prefer explicitly selected file to automatically selected ones. +if test -z "$CONFIG_SITE"; then + if test "x$prefix" != xNONE; then + CONFIG_SITE="$prefix/share/config.site $prefix/etc/config.site" + else + CONFIG_SITE="$ac_default_prefix/share/config.site $ac_default_prefix/etc/config.site" + fi +fi +for ac_site_file in $CONFIG_SITE; do + if test -r "$ac_site_file"; then + echo "loading site script $ac_site_file" + . "$ac_site_file" + fi +done + +if test -r "$cache_file"; then + echo "loading cache $cache_file" + . $cache_file +else + echo "creating cache $cache_file" + > $cache_file +fi + +ac_ext=c +# CFLAGS is not in ac_cpp because -g, -O, etc. are not valid cpp options. +ac_cpp='$CPP $CPPFLAGS' +ac_compile='${CC-cc} -c $CFLAGS $CPPFLAGS conftest.$ac_ext 1>&5' +ac_link='${CC-cc} -o conftest $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS 1>&5' +cross_compiling=$ac_cv_prog_cc_cross + +if (echo "testing\c"; echo 1,2,3) | grep c >/dev/null; then + # Stardent Vistra SVR4 grep lacks -e, says ghazi@caip.rutgers.edu. + if (echo -n testing; echo 1,2,3) | sed s/-n/xn/ | grep xn >/dev/null; then + ac_n= ac_c=' +' ac_t=' ' + else + ac_n=-n ac_c= ac_t= + fi +else + ac_n= ac_c='\c' ac_t= +fi + + + + +# Extract the first word of "gcc", so it can be a program name with args. +set dummy gcc; ac_word=$2 +echo $ac_n "checking for $ac_word""... $ac_c" 1>&6 +echo "configure:528: checking for $ac_word" >&5 +if eval "test \"`echo '$''{'ac_cv_prog_CC'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + if test -n "$CC"; then + ac_cv_prog_CC="$CC" # Let the user override the test. +else + IFS="${IFS= }"; ac_save_ifs="$IFS"; IFS="${IFS}:" + for ac_dir in $PATH; do + test -z "$ac_dir" && ac_dir=. + if test -f $ac_dir/$ac_word; then + ac_cv_prog_CC="gcc" + break + fi + done + IFS="$ac_save_ifs" +fi +fi +CC="$ac_cv_prog_CC" +if test -n "$CC"; then + echo "$ac_t""$CC" 1>&6 +else + echo "$ac_t""no" 1>&6 +fi + +if test -z "$CC"; then + # Extract the first word of "cc", so it can be a program name with args. +set dummy cc; ac_word=$2 +echo $ac_n "checking for $ac_word""... $ac_c" 1>&6 +echo "configure:557: checking for $ac_word" >&5 +if eval "test \"`echo '$''{'ac_cv_prog_CC'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + if test -n "$CC"; then + ac_cv_prog_CC="$CC" # Let the user override the test. +else + IFS="${IFS= }"; ac_save_ifs="$IFS"; IFS="${IFS}:" + ac_prog_rejected=no + for ac_dir in $PATH; do + test -z "$ac_dir" && ac_dir=. + if test -f $ac_dir/$ac_word; then + if test "$ac_dir/$ac_word" = "/usr/ucb/cc"; then + ac_prog_rejected=yes + continue + fi + ac_cv_prog_CC="cc" + break + fi + done + IFS="$ac_save_ifs" +if test $ac_prog_rejected = yes; then + # We found a bogon in the path, so make sure we never use it. + set dummy $ac_cv_prog_CC + shift + if test $# -gt 0; then + # We chose a different compiler from the bogus one. + # However, it has the same basename, so the bogon will be chosen + # first if we set CC to just the basename; use the full file name. + shift + set dummy "$ac_dir/$ac_word" "$@" + shift + ac_cv_prog_CC="$@" + fi +fi +fi +fi +CC="$ac_cv_prog_CC" +if test -n "$CC"; then + echo "$ac_t""$CC" 1>&6 +else + echo "$ac_t""no" 1>&6 +fi + + test -z "$CC" && { echo "configure: error: no acceptable cc found in \$PATH" 1>&2; exit 1; } +fi + +echo $ac_n "checking whether the C compiler ($CC $CFLAGS $LDFLAGS) works""... $ac_c" 1>&6 +echo "configure:605: checking whether the C compiler ($CC $CFLAGS $LDFLAGS) works" >&5 + +ac_ext=c +# CFLAGS is not in ac_cpp because -g, -O, etc. are not valid cpp options. +ac_cpp='$CPP $CPPFLAGS' +ac_compile='${CC-cc} -c $CFLAGS $CPPFLAGS conftest.$ac_ext 1>&5' +ac_link='${CC-cc} -o conftest $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS 1>&5' +cross_compiling=$ac_cv_prog_cc_cross + +cat > conftest.$ac_ext <&5; (eval $ac_link) 2>&5; } && test -s conftest; then + ac_cv_prog_cc_works=yes + # If we can't run a trivial program, we are probably using a cross compiler. + if (./conftest; exit) 2>/dev/null; then + ac_cv_prog_cc_cross=no + else + ac_cv_prog_cc_cross=yes + fi +else + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + ac_cv_prog_cc_works=no +fi +rm -fr conftest* + +echo "$ac_t""$ac_cv_prog_cc_works" 1>&6 +if test $ac_cv_prog_cc_works = no; then + { echo "configure: error: installation or configuration problem: C compiler cannot create executables." 1>&2; exit 1; } +fi +echo $ac_n "checking whether the C compiler ($CC $CFLAGS $LDFLAGS) is a cross-compiler""... $ac_c" 1>&6 +echo "configure:639: checking whether the C compiler ($CC $CFLAGS $LDFLAGS) is a cross-compiler" >&5 +echo "$ac_t""$ac_cv_prog_cc_cross" 1>&6 +cross_compiling=$ac_cv_prog_cc_cross + +echo $ac_n "checking whether we are using GNU C""... $ac_c" 1>&6 +echo "configure:644: checking whether we are using GNU C" >&5 +if eval "test \"`echo '$''{'ac_cv_prog_gcc'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + cat > conftest.c <&5; (eval $ac_try) 2>&5; }; } | egrep yes >/dev/null 2>&1; then + ac_cv_prog_gcc=yes +else + ac_cv_prog_gcc=no +fi +fi + +echo "$ac_t""$ac_cv_prog_gcc" 1>&6 + +if test $ac_cv_prog_gcc = yes; then + GCC=yes + ac_test_CFLAGS="${CFLAGS+set}" + ac_save_CFLAGS="$CFLAGS" + CFLAGS= + echo $ac_n "checking whether ${CC-cc} accepts -g""... $ac_c" 1>&6 +echo "configure:668: checking whether ${CC-cc} accepts -g" >&5 +if eval "test \"`echo '$''{'ac_cv_prog_cc_g'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + echo 'void f(){}' > conftest.c +if test -z "`${CC-cc} -g -c conftest.c 2>&1`"; then + ac_cv_prog_cc_g=yes +else + ac_cv_prog_cc_g=no +fi +rm -f conftest* + +fi + +echo "$ac_t""$ac_cv_prog_cc_g" 1>&6 + if test "$ac_test_CFLAGS" = set; then + CFLAGS="$ac_save_CFLAGS" + elif test $ac_cv_prog_cc_g = yes; then + CFLAGS="-g -O2" + else + CFLAGS="-O2" + fi +else + GCC= + test "${CFLAGS+set}" = set || CFLAGS="-g" +fi + +# Extract the first word of "ranlib", so it can be a program name with args. +set dummy ranlib; ac_word=$2 +echo $ac_n "checking for $ac_word""... $ac_c" 1>&6 +echo "configure:698: checking for $ac_word" >&5 +if eval "test \"`echo '$''{'ac_cv_prog_RANLIB'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + if test -n "$RANLIB"; then + ac_cv_prog_RANLIB="$RANLIB" # Let the user override the test. +else + IFS="${IFS= }"; ac_save_ifs="$IFS"; IFS="${IFS}:" + for ac_dir in $PATH; do + test -z "$ac_dir" && ac_dir=. + if test -f $ac_dir/$ac_word; then + ac_cv_prog_RANLIB="ranlib" + break + fi + done + IFS="$ac_save_ifs" + test -z "$ac_cv_prog_RANLIB" && ac_cv_prog_RANLIB=":" +fi +fi +RANLIB="$ac_cv_prog_RANLIB" +if test -n "$RANLIB"; then + echo "$ac_t""$RANLIB" 1>&6 +else + echo "$ac_t""no" 1>&6 +fi + +ac_aux_dir= +for ac_dir in $srcdir $srcdir/.. $srcdir/../..; do + if test -f $ac_dir/install-sh; then + ac_aux_dir=$ac_dir + ac_install_sh="$ac_aux_dir/install-sh -c" + break + elif test -f $ac_dir/install.sh; then + ac_aux_dir=$ac_dir + ac_install_sh="$ac_aux_dir/install.sh -c" + break + fi +done +if test -z "$ac_aux_dir"; then + { echo "configure: error: can not find install-sh or install.sh in $srcdir $srcdir/.. $srcdir/../.." 1>&2; exit 1; } +fi +ac_config_guess=$ac_aux_dir/config.guess +ac_config_sub=$ac_aux_dir/config.sub +ac_configure=$ac_aux_dir/configure # This should be Cygnus configure. + +# Find a good install program. We prefer a C program (faster), +# so one script is as good as another. But avoid the broken or +# incompatible versions: +# SysV /etc/install, /usr/sbin/install +# SunOS /usr/etc/install +# IRIX /sbin/install +# AIX /bin/install +# AFS /usr/afsws/bin/install, which mishandles nonexistent args +# SVR4 /usr/ucb/install, which tries to use the nonexistent group "staff" +# ./install, which can be erroneously created by make from ./install.sh. +echo $ac_n "checking for a BSD compatible install""... $ac_c" 1>&6 +echo "configure:754: checking for a BSD compatible install" >&5 +if test -z "$INSTALL"; then +if eval "test \"`echo '$''{'ac_cv_path_install'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + IFS="${IFS= }"; ac_save_IFS="$IFS"; IFS="${IFS}:" + for ac_dir in $PATH; do + # Account for people who put trailing slashes in PATH elements. + case "$ac_dir/" in + /|./|.//|/etc/*|/usr/sbin/*|/usr/etc/*|/sbin/*|/usr/afsws/bin/*|/usr/ucb/*) ;; + *) + # OSF1 and SCO ODT 3.0 have their own names for install. + for ac_prog in ginstall installbsd scoinst install; do + if test -f $ac_dir/$ac_prog; then + if test $ac_prog = install && + grep dspmsg $ac_dir/$ac_prog >/dev/null 2>&1; then + # AIX install. It has an incompatible calling convention. + # OSF/1 installbsd also uses dspmsg, but is usable. + : + else + ac_cv_path_install="$ac_dir/$ac_prog -c" + break 2 + fi + fi + done + ;; + esac + done + IFS="$ac_save_IFS" + +fi + if test "${ac_cv_path_install+set}" = set; then + INSTALL="$ac_cv_path_install" + else + # As a last resort, use the slow shell script. We don't cache a + # path for INSTALL within a source directory, because that will + # break other packages using the cache if that directory is + # removed, or if the path is relative. + INSTALL="$ac_install_sh" + fi +fi +echo "$ac_t""$INSTALL" 1>&6 + +# Use test -z because SunOS4 sh mishandles braces in ${var-val}. +# It thinks the first close brace ends the variable substitution. +test -z "$INSTALL_PROGRAM" && INSTALL_PROGRAM='${INSTALL}' + +test -z "$INSTALL_DATA" && INSTALL_DATA='${INSTALL} -m 644' + +echo $ac_n "checking whether ln -s works""... $ac_c" 1>&6 +echo "configure:804: checking whether ln -s works" >&5 +if eval "test \"`echo '$''{'ac_cv_prog_LN_S'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + rm -f conftestdata +if ln -s X conftestdata 2>/dev/null +then + rm -f conftestdata + ac_cv_prog_LN_S="ln -s" +else + ac_cv_prog_LN_S=ln +fi +fi +LN_S="$ac_cv_prog_LN_S" +if test "$ac_cv_prog_LN_S" = "ln -s"; then + echo "$ac_t""yes" 1>&6 +else + echo "$ac_t""no" 1>&6 +fi + + +echo $ac_n "checking how to run the C preprocessor""... $ac_c" 1>&6 +echo "configure:826: checking how to run the C preprocessor" >&5 +# On Suns, sometimes $CPP names a directory. +if test -n "$CPP" && test -d "$CPP"; then + CPP= +fi +if test -z "$CPP"; then +if eval "test \"`echo '$''{'ac_cv_prog_CPP'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + # This must be in double quotes, not single quotes, because CPP may get + # substituted into the Makefile and "${CC-cc}" will confuse make. + CPP="${CC-cc} -E" + # On the NeXT, cc -E runs the code through the compiler's parser, + # not just through cpp. + cat > conftest.$ac_ext < +Syntax Error +EOF +ac_try="$ac_cpp conftest.$ac_ext >/dev/null 2>conftest.out" +{ (eval echo configure:847: \"$ac_try\") 1>&5; (eval $ac_try) 2>&5; } +ac_err=`grep -v '^ *+' conftest.out` +if test -z "$ac_err"; then + : +else + echo "$ac_err" >&5 + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -rf conftest* + CPP="${CC-cc} -E -traditional-cpp" + cat > conftest.$ac_ext < +Syntax Error +EOF +ac_try="$ac_cpp conftest.$ac_ext >/dev/null 2>conftest.out" +{ (eval echo configure:864: \"$ac_try\") 1>&5; (eval $ac_try) 2>&5; } +ac_err=`grep -v '^ *+' conftest.out` +if test -z "$ac_err"; then + : +else + echo "$ac_err" >&5 + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -rf conftest* + CPP=/lib/cpp +fi +rm -f conftest* +fi +rm -f conftest* + ac_cv_prog_CPP="$CPP" +fi + CPP="$ac_cv_prog_CPP" +else + ac_cv_prog_CPP="$CPP" +fi +echo "$ac_t""$CPP" 1>&6 + +echo $ac_n "checking for ANSI C header files""... $ac_c" 1>&6 +echo "configure:887: checking for ANSI C header files" >&5 +if eval "test \"`echo '$''{'ac_cv_header_stdc'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + cat > conftest.$ac_ext < +#include +#include +#include +EOF +ac_try="$ac_cpp conftest.$ac_ext >/dev/null 2>conftest.out" +{ (eval echo configure:900: \"$ac_try\") 1>&5; (eval $ac_try) 2>&5; } +ac_err=`grep -v '^ *+' conftest.out` +if test -z "$ac_err"; then + rm -rf conftest* + ac_cv_header_stdc=yes +else + echo "$ac_err" >&5 + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -rf conftest* + ac_cv_header_stdc=no +fi +rm -f conftest* + +if test $ac_cv_header_stdc = yes; then + # SunOS 4.x string.h does not declare mem*, contrary to ANSI. +cat > conftest.$ac_ext < +EOF +if (eval "$ac_cpp conftest.$ac_ext") 2>&5 | + egrep "memchr" >/dev/null 2>&1; then + : +else + rm -rf conftest* + ac_cv_header_stdc=no +fi +rm -f conftest* + +fi + +if test $ac_cv_header_stdc = yes; then + # ISC 2.0.2 stdlib.h does not declare free, contrary to ANSI. +cat > conftest.$ac_ext < +EOF +if (eval "$ac_cpp conftest.$ac_ext") 2>&5 | + egrep "free" >/dev/null 2>&1; then + : +else + rm -rf conftest* + ac_cv_header_stdc=no +fi +rm -f conftest* + +fi + +if test $ac_cv_header_stdc = yes; then + # /bin/cc in Irix-4.0.5 gets non-ANSI ctype macros unless using -ansi. +if test "$cross_compiling" = yes; then + : +else + cat > conftest.$ac_ext < +#define ISLOWER(c) ('a' <= (c) && (c) <= 'z') +#define TOUPPER(c) (ISLOWER(c) ? 'A' + ((c) - 'a') : (c)) +#define XOR(e, f) (((e) && !(f)) || (!(e) && (f))) +int main () { int i; for (i = 0; i < 256; i++) +if (XOR (islower (i), ISLOWER (i)) || toupper (i) != TOUPPER (i)) exit(2); +exit (0); } + +EOF +if { (eval echo configure:967: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest && (./conftest; exit) 2>/dev/null +then + : +else + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -fr conftest* + ac_cv_header_stdc=no +fi +rm -fr conftest* +fi + +fi +fi + +echo "$ac_t""$ac_cv_header_stdc" 1>&6 +if test $ac_cv_header_stdc = yes; then + cat >> confdefs.h <<\EOF +#define STDC_HEADERS 1 +EOF + +fi + + +for ac_hdr in linux/sound.h +do +ac_safe=`echo "$ac_hdr" | sed 'y%./+-%__p_%'` +echo $ac_n "checking for $ac_hdr""... $ac_c" 1>&6 +echo "configure:995: checking for $ac_hdr" >&5 +if eval "test \"`echo '$''{'ac_cv_header_$ac_safe'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + cat > conftest.$ac_ext < +EOF +ac_try="$ac_cpp conftest.$ac_ext >/dev/null 2>conftest.out" +{ (eval echo configure:1005: \"$ac_try\") 1>&5; (eval $ac_try) 2>&5; } +ac_err=`grep -v '^ *+' conftest.out` +if test -z "$ac_err"; then + rm -rf conftest* + eval "ac_cv_header_$ac_safe=yes" +else + echo "$ac_err" >&5 + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -rf conftest* + eval "ac_cv_header_$ac_safe=no" +fi +rm -f conftest* +fi +if eval "test \"`echo '$ac_cv_header_'$ac_safe`\" = yes"; then + echo "$ac_t""yes" 1>&6 + ac_tr_hdr=HAVE_`echo $ac_hdr | sed 'y%abcdefghijklmnopqrstuvwxyz./-%ABCDEFGHIJKLMNOPQRSTUVWXYZ___%'` + cat >> confdefs.h <&6 +fi +done + + +echo $ac_n "checking for working const""... $ac_c" 1>&6 +echo "configure:1033: checking for working const" >&5 +if eval "test \"`echo '$''{'ac_cv_c_const'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + cat > conftest.$ac_ext <j = 5; +} +{ /* ULTRIX-32 V3.1 (Rev 9) vcc rejects this */ + const int foo = 10; +} + +; return 0; } +EOF +if { (eval echo configure:1087: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>&5; }; then + rm -rf conftest* + ac_cv_c_const=yes +else + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -rf conftest* + ac_cv_c_const=no +fi +rm -f conftest* +fi + +echo "$ac_t""$ac_cv_c_const" 1>&6 +if test $ac_cv_c_const = no; then + cat >> confdefs.h <<\EOF +#define const +EOF + +fi + +echo $ac_n "checking for inline""... $ac_c" 1>&6 +echo "configure:1108: checking for inline" >&5 +if eval "test \"`echo '$''{'ac_cv_c_inline'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + ac_cv_c_inline=no +for ac_kw in inline __inline__ __inline; do + cat > conftest.$ac_ext <&5; (eval $ac_compile) 2>&5; }; then + rm -rf conftest* + ac_cv_c_inline=$ac_kw; break +else + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 +fi +rm -f conftest* +done + +fi + +echo "$ac_t""$ac_cv_c_inline" 1>&6 +case "$ac_cv_c_inline" in + inline | yes) ;; + no) cat >> confdefs.h <<\EOF +#define inline +EOF + ;; + *) cat >> confdefs.h <&6 +echo "configure:1148: checking whether byte ordering is bigendian" >&5 +if eval "test \"`echo '$''{'ac_cv_c_bigendian'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + ac_cv_c_bigendian=unknown +# See if sys/param.h defines the BYTE_ORDER macro. +cat > conftest.$ac_ext < +#include +int main() { + +#if !BYTE_ORDER || !BIG_ENDIAN || !LITTLE_ENDIAN + bogus endian macros +#endif +; return 0; } +EOF +if { (eval echo configure:1166: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>&5; }; then + rm -rf conftest* + # It does; now see whether it defined to BIG_ENDIAN or not. +cat > conftest.$ac_ext < +#include +int main() { + +#if BYTE_ORDER != BIG_ENDIAN + not big endian +#endif +; return 0; } +EOF +if { (eval echo configure:1181: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>&5; }; then + rm -rf conftest* + ac_cv_c_bigendian=yes +else + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -rf conftest* + ac_cv_c_bigendian=no +fi +rm -f conftest* +else + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 +fi +rm -f conftest* +if test $ac_cv_c_bigendian = unknown; then +if test "$cross_compiling" = yes; then + { echo "configure: error: can not run test program while cross compiling" 1>&2; exit 1; } +else + cat > conftest.$ac_ext <&5; (eval $ac_link) 2>&5; } && test -s conftest && (./conftest; exit) 2>/dev/null +then + ac_cv_c_bigendian=no +else + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -fr conftest* + ac_cv_c_bigendian=yes +fi +rm -fr conftest* +fi + +fi +fi + +echo "$ac_t""$ac_cv_c_bigendian" 1>&6 +if test $ac_cv_c_bigendian = yes; then + cat >> confdefs.h <<\EOF +#define WORDS_BIGENDIAN 1 +EOF + +fi + +echo $ac_n "checking whether time.h and sys/time.h may both be included""... $ac_c" 1>&6 +echo "configure:1238: checking whether time.h and sys/time.h may both be included" >&5 +if eval "test \"`echo '$''{'ac_cv_header_time'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + cat > conftest.$ac_ext < +#include +#include +int main() { +struct tm *tp; +; return 0; } +EOF +if { (eval echo configure:1252: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>&5; }; then + rm -rf conftest* + ac_cv_header_time=yes +else + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -rf conftest* + ac_cv_header_time=no +fi +rm -f conftest* +fi + +echo "$ac_t""$ac_cv_header_time" 1>&6 +if test $ac_cv_header_time = yes; then + cat >> confdefs.h <<\EOF +#define TIME_WITH_SYS_TIME 1 +EOF + +fi + + +if test $ac_cv_prog_gcc = yes; then + echo $ac_n "checking whether ${CC-cc} needs -traditional""... $ac_c" 1>&6 +echo "configure:1275: checking whether ${CC-cc} needs -traditional" >&5 +if eval "test \"`echo '$''{'ac_cv_prog_gcc_traditional'+set}'`\" = set"; then + echo $ac_n "(cached) $ac_c" 1>&6 +else + ac_pattern="Autoconf.*'x'" + cat > conftest.$ac_ext < +Autoconf TIOCGETP +EOF +if (eval "$ac_cpp conftest.$ac_ext") 2>&5 | + egrep "$ac_pattern" >/dev/null 2>&1; then + rm -rf conftest* + ac_cv_prog_gcc_traditional=yes +else + rm -rf conftest* + ac_cv_prog_gcc_traditional=no +fi +rm -f conftest* + + + if test $ac_cv_prog_gcc_traditional = no; then + cat > conftest.$ac_ext < +Autoconf TCGETA +EOF +if (eval "$ac_cpp conftest.$ac_ext") 2>&5 | + egrep "$ac_pattern" >/dev/null 2>&1; then + rm -rf conftest* + ac_cv_prog_gcc_traditional=yes +fi +rm -f conftest* + + fi +fi + +echo "$ac_t""$ac_cv_prog_gcc_traditional" 1>&6 + if test $ac_cv_prog_gcc_traditional = yes; then + CC="$CC -traditional" + fi +fi + + +myprefix=$prefix +if test "$myprefix" = "NONE"; then + myprefix=$ac_default_prefix +fi +CFLAGS="-I$myprefix/include" +#echo "CFLAGS=$CFLAGS" +echo $ac_n "checking for alsa-driver package""... $ac_c" 1>&6 +echo "configure:1328: checking for alsa-driver package" >&5 +if test "$cross_compiling" = yes; then + echo "$ac_t"""not supported"" 1>&6; echo "Fatal error: Cross-compiling isn't supported..."; exit 1; +else + cat > conftest.$ac_ext < +void main(void) +{ +#ifndef SND_PROTOCOL_VERSION + exit(1); +#else + exit(0); +#endif +} + +EOF +if { (eval echo configure:1347: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest && (./conftest; exit) 2>/dev/null +then + echo "$ac_t"""present"" 1>&6 +else + echo "configure: failed program was:" >&5 + cat conftest.$ac_ext >&5 + rm -fr conftest* + echo "$ac_t"""not found"" 1>&6; echo "Fatal error: Install alsa-driver package at first..."; exit 1; +fi +rm -fr conftest* +fi + + +echo $ac_n "checking for library version""... $ac_c" 1>&6 +echo "configure:1361: checking for library version" >&5 +SND_LIB_VERSION=`cat $srcdir/version` +cat >> confdefs.h <&6 + +trap '' 1 2 15 +cat > confcache <<\EOF +# This file is a shell script that caches the results of configure +# tests run on this system so they can be shared between configure +# scripts and configure runs. It is not useful on other systems. +# If it contains results you don't want to keep, you may remove or edit it. +# +# By default, configure uses ./config.cache as the cache file, +# creating it if it does not exist already. You can give configure +# the --cache-file=FILE option to use a different cache file; that is +# what configure does when it calls configure scripts in +# subdirectories, so they share the cache. +# Giving --cache-file=/dev/null disables caching, for debugging configure. +# config.status only pays attention to the cache file if you give it the +# --recheck option to rerun configure. +# +EOF +# The following way of writing the cache mishandles newlines in values, +# but we know of no workaround that is simple, portable, and efficient. +# So, don't put newlines in cache variables' values. +# Ultrix sh set writes to stderr and can't be redirected directly, +# and sets the high bit in the cache file unless we assign to the vars. +(set) 2>&1 | + case `(ac_space=' '; set) 2>&1` in + *ac_space=\ *) + # `set' does not quote correctly, so add quotes (double-quote substitution + # turns \\\\ into \\, and sed turns \\ into \). + sed -n \ + -e "s/'/'\\\\''/g" \ + -e "s/^\\([a-zA-Z0-9_]*_cv_[a-zA-Z0-9_]*\\)=\\(.*\\)/\\1=\${\\1='\\2'}/p" + ;; + *) + # `set' quotes correctly as required by POSIX, so do not add quotes. + sed -n -e 's/^\([a-zA-Z0-9_]*_cv_[a-zA-Z0-9_]*\)=\(.*\)/\1=${\1=\2}/p' + ;; + esac >> confcache +if cmp -s $cache_file confcache; then + : +else + if test -w $cache_file; then + echo "updating cache $cache_file" + cat confcache > $cache_file + else + echo "not updating unwritable cache $cache_file" + fi +fi +rm -f confcache + +trap 'rm -fr conftest* confdefs* core core.* *.core $ac_clean_files; exit 1' 1 2 15 + +test "x$prefix" = xNONE && prefix=$ac_default_prefix +# Let make expand exec_prefix. +test "x$exec_prefix" = xNONE && exec_prefix='${prefix}' + +# Any assignment to VPATH causes Sun make to only execute +# the first set of double-colon rules, so remove it if not needed. +# If there is a colon in the path, we need to keep it. +if test "x$srcdir" = x.; then + ac_vpsub='/^[ ]*VPATH[ ]*=[^:]*$/d' +fi + +trap 'rm -f $CONFIG_STATUS conftest*; exit 1' 1 2 15 + +DEFS=-DHAVE_CONFIG_H + +# Without the "./", some shells look in PATH for config.status. +: ${CONFIG_STATUS=./config.status} + +echo creating $CONFIG_STATUS +rm -f $CONFIG_STATUS +cat > $CONFIG_STATUS </dev/null | sed 1q`: +# +# $0 $ac_configure_args +# +# Compiler output produced by configure, useful for debugging +# configure, is in ./config.log if it exists. + +ac_cs_usage="Usage: $CONFIG_STATUS [--recheck] [--version] [--help]" +for ac_option +do + case "\$ac_option" in + -recheck | --recheck | --rechec | --reche | --rech | --rec | --re | --r) + echo "running \${CONFIG_SHELL-/bin/sh} $0 $ac_configure_args --no-create --no-recursion" + exec \${CONFIG_SHELL-/bin/sh} $0 $ac_configure_args --no-create --no-recursion ;; + -version | --version | --versio | --versi | --vers | --ver | --ve | --v) + echo "$CONFIG_STATUS generated by autoconf version 2.12" + exit 0 ;; + -help | --help | --hel | --he | --h) + echo "\$ac_cs_usage"; exit 0 ;; + *) echo "\$ac_cs_usage"; exit 1 ;; + esac +done + +ac_given_srcdir=$srcdir +ac_given_INSTALL="$INSTALL" + +trap 'rm -fr `echo "Makefile.conf include/version.h utils/alsa-lib.spec include/config.h" | sed "s/:[^ ]*//g"` conftest*; exit 1' 1 2 15 +EOF +cat >> $CONFIG_STATUS < conftest.subs <<\\CEOF +$ac_vpsub +$extrasub +s%@CFLAGS@%$CFLAGS%g +s%@CPPFLAGS@%$CPPFLAGS%g +s%@CXXFLAGS@%$CXXFLAGS%g +s%@DEFS@%$DEFS%g +s%@LDFLAGS@%$LDFLAGS%g +s%@LIBS@%$LIBS%g +s%@exec_prefix@%$exec_prefix%g +s%@prefix@%$prefix%g +s%@program_transform_name@%$program_transform_name%g +s%@bindir@%$bindir%g +s%@sbindir@%$sbindir%g +s%@libexecdir@%$libexecdir%g +s%@datadir@%$datadir%g +s%@sysconfdir@%$sysconfdir%g +s%@sharedstatedir@%$sharedstatedir%g +s%@localstatedir@%$localstatedir%g +s%@libdir@%$libdir%g +s%@includedir@%$includedir%g +s%@oldincludedir@%$oldincludedir%g +s%@infodir@%$infodir%g +s%@mandir@%$mandir%g +s%@CC@%$CC%g +s%@RANLIB@%$RANLIB%g +s%@INSTALL_PROGRAM@%$INSTALL_PROGRAM%g +s%@INSTALL_DATA@%$INSTALL_DATA%g +s%@LN_S@%$LN_S%g +s%@CPP@%$CPP%g +s%@SND_LIB_VERSION@%$SND_LIB_VERSION%g +s%@SND_LIB_MAJOR@%$SND_LIB_MAJOR%g +s%@SND_LIB_MINOR@%$SND_LIB_MINOR%g +s%@SND_LIB_SUBMINOR@%$SND_LIB_SUBMINOR%g + +CEOF +EOF + +cat >> $CONFIG_STATUS <<\EOF + +# Split the substitutions into bite-sized pieces for seds with +# small command number limits, like on Digital OSF/1 and HP-UX. +ac_max_sed_cmds=90 # Maximum number of lines to put in a sed script. +ac_file=1 # Number of current file. +ac_beg=1 # First line for current file. +ac_end=$ac_max_sed_cmds # Line after last line for current file. +ac_more_lines=: +ac_sed_cmds="" +while $ac_more_lines; do + if test $ac_beg -gt 1; then + sed "1,${ac_beg}d; ${ac_end}q" conftest.subs > conftest.s$ac_file + else + sed "${ac_end}q" conftest.subs > conftest.s$ac_file + fi + if test ! -s conftest.s$ac_file; then + ac_more_lines=false + rm -f conftest.s$ac_file + else + if test -z "$ac_sed_cmds"; then + ac_sed_cmds="sed -f conftest.s$ac_file" + else + ac_sed_cmds="$ac_sed_cmds | sed -f conftest.s$ac_file" + fi + ac_file=`expr $ac_file + 1` + ac_beg=$ac_end + ac_end=`expr $ac_end + $ac_max_sed_cmds` + fi +done +if test -z "$ac_sed_cmds"; then + ac_sed_cmds=cat +fi +EOF + +cat >> $CONFIG_STATUS <> $CONFIG_STATUS <<\EOF +for ac_file in .. $CONFIG_FILES; do if test "x$ac_file" != x..; then + # Support "outfile[:infile[:infile...]]", defaulting infile="outfile.in". + case "$ac_file" in + *:*) ac_file_in=`echo "$ac_file"|sed 's%[^:]*:%%'` + ac_file=`echo "$ac_file"|sed 's%:.*%%'` ;; + *) ac_file_in="${ac_file}.in" ;; + esac + + # Adjust a relative srcdir, top_srcdir, and INSTALL for subdirectories. + + # Remove last slash and all that follows it. Not all systems have dirname. + ac_dir=`echo $ac_file|sed 's%/[^/][^/]*$%%'` + if test "$ac_dir" != "$ac_file" && test "$ac_dir" != .; then + # The file is in a subdirectory. + test ! -d "$ac_dir" && mkdir "$ac_dir" + ac_dir_suffix="/`echo $ac_dir|sed 's%^\./%%'`" + # A "../" for each directory in $ac_dir_suffix. + ac_dots=`echo $ac_dir_suffix|sed 's%/[^/]*%../%g'` + else + ac_dir_suffix= ac_dots= + fi + + case "$ac_given_srcdir" in + .) srcdir=. + if test -z "$ac_dots"; then top_srcdir=. + else top_srcdir=`echo $ac_dots|sed 's%/$%%'`; fi ;; + /*) srcdir="$ac_given_srcdir$ac_dir_suffix"; top_srcdir="$ac_given_srcdir" ;; + *) # Relative path. + srcdir="$ac_dots$ac_given_srcdir$ac_dir_suffix" + top_srcdir="$ac_dots$ac_given_srcdir" ;; + esac + + case "$ac_given_INSTALL" in + [/$]*) INSTALL="$ac_given_INSTALL" ;; + *) INSTALL="$ac_dots$ac_given_INSTALL" ;; + esac + + echo creating "$ac_file" + rm -f "$ac_file" + configure_input="Generated automatically from `echo $ac_file_in|sed 's%.*/%%'` by configure." + case "$ac_file" in + *Makefile*) ac_comsub="1i\\ +# $configure_input" ;; + *) ac_comsub= ;; + esac + + ac_file_inputs=`echo $ac_file_in|sed -e "s%^%$ac_given_srcdir/%" -e "s%:% $ac_given_srcdir/%g"` + sed -e "$ac_comsub +s%@configure_input@%$configure_input%g +s%@srcdir@%$srcdir%g +s%@top_srcdir@%$top_srcdir%g +s%@INSTALL@%$INSTALL%g +" $ac_file_inputs | (eval "$ac_sed_cmds") > $ac_file +fi; done +rm -f conftest.s* + +# These sed commands are passed to sed as "A NAME B NAME C VALUE D", where +# NAME is the cpp macro being defined and VALUE is the value it is being given. +# +# ac_d sets the value in "#define NAME VALUE" lines. +ac_dA='s%^\([ ]*\)#\([ ]*define[ ][ ]*\)' +ac_dB='\([ ][ ]*\)[^ ]*%\1#\2' +ac_dC='\3' +ac_dD='%g' +# ac_u turns "#undef NAME" with trailing blanks into "#define NAME VALUE". +ac_uA='s%^\([ ]*\)#\([ ]*\)undef\([ ][ ]*\)' +ac_uB='\([ ]\)%\1#\2define\3' +ac_uC=' ' +ac_uD='\4%g' +# ac_e turns "#undef NAME" without trailing blanks into "#define NAME VALUE". +ac_eA='s%^\([ ]*\)#\([ ]*\)undef\([ ][ ]*\)' +ac_eB='$%\1#\2define\3' +ac_eC=' ' +ac_eD='%g' + +if test "${CONFIG_HEADERS+set}" != set; then +EOF +cat >> $CONFIG_STATUS <> $CONFIG_STATUS <<\EOF +fi +for ac_file in .. $CONFIG_HEADERS; do if test "x$ac_file" != x..; then + # Support "outfile[:infile[:infile...]]", defaulting infile="outfile.in". + case "$ac_file" in + *:*) ac_file_in=`echo "$ac_file"|sed 's%[^:]*:%%'` + ac_file=`echo "$ac_file"|sed 's%:.*%%'` ;; + *) ac_file_in="${ac_file}.in" ;; + esac + + echo creating $ac_file + + rm -f conftest.frag conftest.in conftest.out + ac_file_inputs=`echo $ac_file_in|sed -e "s%^%$ac_given_srcdir/%" -e "s%:% $ac_given_srcdir/%g"` + cat $ac_file_inputs > conftest.in + +EOF + +# Transform confdefs.h into a sed script conftest.vals that substitutes +# the proper values into config.h.in to produce config.h. And first: +# Protect against being on the right side of a sed subst in config.status. +# Protect against being in an unquoted here document in config.status. +rm -f conftest.vals +cat > conftest.hdr <<\EOF +s/[\\&%]/\\&/g +s%[\\$`]%\\&%g +s%#define \([A-Za-z_][A-Za-z0-9_]*\) *\(.*\)%${ac_dA}\1${ac_dB}\1${ac_dC}\2${ac_dD}%gp +s%ac_d%ac_u%gp +s%ac_u%ac_e%gp +EOF +sed -n -f conftest.hdr confdefs.h > conftest.vals +rm -f conftest.hdr + +# This sed command replaces #undef with comments. This is necessary, for +# example, in the case of _POSIX_SOURCE, which is predefined and required +# on some systems where configure will not decide to define it. +cat >> conftest.vals <<\EOF +s%^[ ]*#[ ]*undef[ ][ ]*[a-zA-Z_][a-zA-Z_0-9]*%/* & */% +EOF + +# Break up conftest.vals because some shells have a limit on +# the size of here documents, and old seds have small limits too. + +rm -f conftest.tail +while : +do + ac_lines=`grep -c . conftest.vals` + # grep -c gives empty output for an empty file on some AIX systems. + if test -z "$ac_lines" || test "$ac_lines" -eq 0; then break; fi + # Write a limited-size here document to conftest.frag. + echo ' cat > conftest.frag <> $CONFIG_STATUS + sed ${ac_max_here_lines}q conftest.vals >> $CONFIG_STATUS + echo 'CEOF + sed -f conftest.frag conftest.in > conftest.out + rm -f conftest.in + mv conftest.out conftest.in +' >> $CONFIG_STATUS + sed 1,${ac_max_here_lines}d conftest.vals > conftest.tail + rm -f conftest.vals + mv conftest.tail conftest.vals +done +rm -f conftest.vals + +cat >> $CONFIG_STATUS <<\EOF + rm -f conftest.frag conftest.h + echo "/* $ac_file. Generated automatically by configure. */" > conftest.h + cat conftest.in >> conftest.h + rm -f conftest.in + if cmp -s $ac_file conftest.h 2>/dev/null; then + echo "$ac_file is unchanged" + rm -f conftest.h + else + # Remove last slash and all that follows it. Not all systems have dirname. + ac_dir=`echo $ac_file|sed 's%/[^/][^/]*$%%'` + if test "$ac_dir" != "$ac_file" && test "$ac_dir" != .; then + # The file is in a subdirectory. + test ! -d "$ac_dir" && mkdir "$ac_dir" + fi + rm -f $ac_file + mv conftest.h $ac_file + fi +fi; done + +EOF +cat >> $CONFIG_STATUS <> $CONFIG_STATUS <<\EOF + +exit 0 +EOF +chmod +x $CONFIG_STATUS +rm -fr confdefs* $ac_clean_files +test "$no_create" = yes || ${CONFIG_SHELL-/bin/sh} $CONFIG_STATUS || exit 1 + diff --git a/configure.in b/configure.in new file mode 100644 index 00000000..8306e15e --- /dev/null +++ b/configure.in @@ -0,0 +1,63 @@ +dnl Process this file with autoconf to produce a configure script. + +AC_INIT(Makefile.conf.in) +AC_PREFIX_DEFAULT(/usr) + +dnl Checks for programs. +AC_PROG_CC +AC_PROG_RANLIB +AC_PROG_INSTALL +AC_PROG_LN_S + +dnl Checks for header files. +AC_HEADER_STDC +AC_CONFIG_HEADER(include/config.h) +AC_CHECK_HEADERS(linux/sound.h) + +dnl Checks for typedefs, structures, and compiler characteristics. +AC_C_CONST +AC_C_INLINE +AC_C_BIGENDIAN +AC_HEADER_TIME + +dnl Checks for library functions. +AC_PROG_GCC_TRADITIONAL + +dnl Check for ALSA driver package. +myprefix=$prefix +if test "$myprefix" = "NONE"; then + myprefix=$ac_default_prefix +fi +CFLAGS="-I$myprefix/include" +#echo "CFLAGS=$CFLAGS" +AC_MSG_CHECKING(for alsa-driver package) +AC_TRY_RUN([ +#include +void main(void) +{ +#ifndef SND_PROTOCOL_VERSION + exit(1); +#else + exit(0); +#endif +} +], + AC_MSG_RESULT("present"), + AC_MSG_RESULT("not found"); echo "Fatal error: Install alsa-driver package at first..."; exit 1;, + AC_MSG_RESULT("not supported"); echo "Fatal error: Cross-compiling isn't supported..."; exit 1;, +) + +dnl Check for version... +AC_MSG_CHECKING(for library version) +SND_LIB_VERSION=`cat $srcdir/version` +AC_DEFINE_UNQUOTED(SND_LIB_VERSION, "$SND_LIB_VERSION") +AC_SUBST(SND_LIB_VERSION) +SND_LIB_MAJOR=`echo $SND_LIB_VERSION | cut -d . -f 1` +AC_SUBST(SND_LIB_MAJOR) +SND_LIB_MINOR=`echo $SND_LIB_VERSION | cut -d . -f 2` +AC_SUBST(SND_LIB_MINOR) +SND_LIB_SUBMINOR=`echo $SND_LIB_VERSION | cut -d . -f 3` +AC_SUBST(SND_LIB_SUBMINOR) +AC_MSG_RESULT($SND_LIB_VERSION) + +AC_OUTPUT(Makefile.conf include/version.h utils/alsa-lib.spec) diff --git a/doc/Makefile b/doc/Makefile new file mode 100644 index 00000000..708995bf --- /dev/null +++ b/doc/Makefile @@ -0,0 +1,20 @@ +# +# Makefile for ALSA library +# Copyright (c) 1994-98 by Jaroslav Kysela +# + +include ../Makefile.conf + +TARGETS=soundapi.txt \ + soundapi.html + +all: $(TARGETS) + +soundapi.txt: soundapi.sgml + sgml2txt soundapi.sgml + +soundapi.html: soundapi.sgml + sgml2html soundapi.sgml + +clean: + rm -f core .depend *.orig *~ diff --git a/doc/plan.txt b/doc/plan.txt new file mode 100644 index 00000000..0f0fa4d7 --- /dev/null +++ b/doc/plan.txt @@ -0,0 +1,47 @@ + + ALSA library plan + ================= + +===== +ST: Status of coding +NT: Note +RP: Responsible person + +This file is maintained by Jaroslav Kysela . +===== + + Library code + ============ + +1: Control interface routines + ST: Low-Level code done + RP: Jaroslav Kysela +1.1: Network layer +2: MIXER routines + ST: Low-Level code done + RP: Jaroslav Kysela +2.1: Network layer +3: PCM routines + ST: Low-Level code done + RP: Jaroslav Kysela +3.1: Network layer + mixing routines to allow playback more than one input + to one exclusive device +3.2: Player routines for digital data (.wav,.snd,.mp3 etc...) (???) +4: Instrument loading routines +4.1: Network layer +4.2: Instrument format interface +4.2.1: GF1 patches (.pat) +4.2.2: AMD FFFF +4.2.3: SoundFont (for SoundBlaster) +4.2.4: FM/OPL3 instrument formats +5: Raw FM/OPL3 interface +6: SYNTH interface +6.1: Network layer +6.2: player for .MOD,.S3M etc. (???) +7: Instrument server interface +8: Instrument configuration routines for MIDI +9: raw MIDI interface +9.1: Network layer +10: sequenced MIDI interface +10.1: Network layer +10.2: player for MIDI files diff --git a/doc/soundapi-1.html b/doc/soundapi-1.html new file mode 100644 index 00000000..f58691a2 --- /dev/null +++ b/doc/soundapi-1.html @@ -0,0 +1,34 @@ + + +Advanced Linux Sound Architecture - Library API: Introduction + + +Previous +Next +Table of Contents +
+

1. Introduction

+ +

The Advanced Linux Sound Architecture comes with a kernel API & library API. +This document describes the library API and how it interfaces with the kernel +API. The kernal API will probably never be documented in standalone form.

+

Application programmers should use the library API rather than kernel API. +The Library offers 100% of the functionally of the kernel API, but add next +major improvements in usability, making the application code simpler and +better looking. In addition, some of the some fixes/compatibility code in, +may be placed in the library code instead of the kernel driver.

+

For a complete list of all variables and functions in the API you should look +at the following header files: +

    +
  1. /usr/include/sys/soundlib.h
    2. +
  2. /usr/include/linux/sound.h
    3. +
  3. /usr/include/linux/sounddetect.h
    4. +
+

+ +
+Previous +Next +Table of Contents + + diff --git a/doc/soundapi-2.html b/doc/soundapi-2.html new file mode 100644 index 00000000..5c743b1e --- /dev/null +++ b/doc/soundapi-2.html @@ -0,0 +1,44 @@ + + +Advanced Linux Sound Architecture - Library API: Error Codes + + +Previous +Next +Table of Contents +
+

2. Error Codes

+ +

All functions return int (or some sort of signed value). If this value +is negative it represents an error code. Codes up to SND_ERROR_BEGIN (500000) +represents standard system errors. Codes equal or greather than this value +represents sound library API errors. All error codes begin with the prefix +SND_ERROR_.

+ +

2.1 Error Codes in Detail

+ +

+

+
SND_ERROR_UNCOMPATIBLE_VERSION (500000)

This error is caused if the driver uses an incompatible kernel API for this +interface and hence the library doesn't know how this API can be used.

+
+

+ + +

2.2 Functions

+ + + +

const char *snd_strerror( int errnum )

+ +

This functions converts error code to a string. Its functionality is the same +as the strerror function from the standard C library, but this +function returns correct strings for sound error codes, too.

+ + +
+Previous +Next +Table of Contents + + diff --git a/doc/soundapi-3.html b/doc/soundapi-3.html new file mode 100644 index 00000000..47daa30d --- /dev/null +++ b/doc/soundapi-3.html @@ -0,0 +1,159 @@ + + +Advanced Linux Sound Architecture - Library API: Control Interface + + +Previous +Next +Table of Contents +
+

3. Control Interface

+ +

The control interfaces gives application various information about the +currently installed sound driver in the system. The interface should be used +to detect if another sound interface is present for selected soundcard or, +for example, to create a list of devices (MIXER, PCM etc) from which +the user can select.

+ +

3.1 Low-Level Layer

+ +

int snd_cards( void )

+ +

Returns the number of soundcards present in the system, if any. Otherwise +it returns a negative value, which maps to an error code. This function +will return 0 if no soundcards are detected.

+ +

unsigned int snd_cards_mask( void )

+ +

Returns the bitmap of soundcards present in the system, if any. Otherwise +it returns a negative value, which maps to an error code. This function +will return 0 if no soundcards are detected. First soundcard is represented +with bit 0.

+ +

int snd_ctl_open( void **handle, int card )

+ +

Creates a new handle and opens communication with the kernel sound +control interface for soundcard number card (0-N). The function +also checks if protocol is compatible, so as to prevent the use of old +programs with a new kernel API. Function returns zero if successful, +otherwise an error code is returned.

+ +

int snd_ctl_close( void *handle )

+ +

Function frees all resources allocated with control handle and +closes the kernel sound control interface. Function returns zero if +successful, otherwise it returns an error code.

+ +

int snd_ctl_file_descriptor( void *handle )

+ +

Function returns file descriptor for the kernel sound control interface. +This function should be used in very special cases. Function returns +a negative error code if some error was encountered.

+ +

int snd_ctl_hw_info( void *handle, struct snd_ctl_hw_info *info )

+ +

Fills the info structure with data about the sound hardware referenced +by handle. Function returns zero if successful, otherwise it returns +an error code. +

+
+  #define SND_CTL_GCAPS_MIDI              0x0000001       /* driver has MIDI interface */
+
+  #define SND_CTL_LCAPS_SYNTH             0x0000001       /* soundcard has synthesizer */
+  #define SND_CTL_LCAPS_RAWFM             0x0000002       /* soundcard has RAW FM/OPL3 */
+
+  struct snd_ctl_hw_info {
+    unsigned int type;            /* type of card - see SND_CARD_TYPE_XXXX */
+    unsigned int gcaps;           /* see SND_CTL_GCAPS_XXXX */
+    unsigned int lcaps;           /* see SND_CTL_LCAPS_XXXX */
+    unsigned int pcmdevs;         /* count of PCM devices (0 to N) */
+    unsigned int mixerdevs;       /* count of MIXER devices (0 to N) */
+    unsigned int mididevs;        /* count of raw MIDI devices (0 to N) */
+    char id[8];                   /* ID of card (user selectable) */
+    char name[80];                /* name/info text about soundcard */
+    unsigned char reserved[128];  /* reserved for future use */
+  };
+  
+
+
+

+ +

int snd_ctl_pcm_info( void *handle, int dev, snd_pcm_info_t *info )

+ +

Fills the *info structure with data about the PCM device. Function returns +zero if successful, otherwise it returns an error code. Details about +the snd_pcm_info_t structure are in the Digital Audio (PCM) Interface +section. The argument dev selects the device number for the +soundcard referenced by *handle. Its range is 0 to N where N is +struct snd_ctl_hw_info -> pcmdevs - 1. This function will work if +the selected PCM device is busy, too. It should be used to collect +information about PCM devices without exclusive lock.

+ +

int snd_ctl_pcm_playback_info( void *handle, int dev, snd_pcm_playback_info_t *info )

+ +

Fills the *info structure with data about the PCM device and playback direction. +Function returns zero if successful, otherwise it returns an error code. +Details about the snd_pcm_playback_info_t structure are in the +Digital Audio (PCM) Interface section. The argument dev +selects the device number for the soundcard referenced by *handle. Its +range is 0 to N where N is struct snd_ctl_hw_info -> pcmdevs - 1. +This function will work if the selected PCM device is busy, too. It should +be used to collect information about PCM devices without exclusive lock.

+ +

int snd_ctl_pcm_record_info( void *handle, int dev, snd_pcm_record_info_t *info )

+ +

Fills the *info structure with data about the PCM device and record direction. +Function returns zero if successful, otherwise it returns an error code. +Details about the snd_pcm_record_info_t structure are in the +Digital Audio (PCM) Interface section. The argument dev +selects the device number for the soundcard referenced by *handle. Its +range is 0 to N where N is struct snd_ctl_hw_info -> pcmdevs - 1. +This function will work if the selected PCM device is busy, too. It should +be used to collect information about PCM devices without exclusive lock.

+ +

int snd_ctl_mixer_info( void *handle, int dev, snd_mixer_info_t *info )

+ +

Fills the *info structure with data about the mixer device. Returns zero +if successful, otherwise it returns an error code. Details about the +snd_mixer_info_t structure are in the Mixer Interface section. +The argument dev specifies the device number for the appropriate +soundcard. Its range is 0 to N where N found from +struct snd_ctl_hw_info -> mixerdevs - 1. +It should be used to collect information about mixer devices.

+ + +

3.2 Examples

+ +

The following example shows how all PCM devices can be detected for the first +soundcard (#0) in the system.

+

+

+
+
+int card = 0, err;
+void *handle;
+stuct snd_ctl_hw_info info;
+
+if ( (err = snd_ctl_open( &handle, card )) < 0 ) {
+  fprintf( stderr, "open failed: %s\n", snd_strerror( err ) );
+  return;
+}
+if ( (err = snd_ctl_hw_info( handle, &info )) < 0 ) {
+  fprintf( stderr, "hw info failed: %s\n", snd_strerror( err ) );
+  snd_ctl_close( handle );
+  return;
+}
+printf( "Installed PCM devices for card #i: %i\n", card + 1, info.pcmdevs );
+snd_ctl_close( handle );
+
+
+
+

+ + +
+Previous +Next +Table of Contents + + diff --git a/doc/soundapi-4.html b/doc/soundapi-4.html new file mode 100644 index 00000000..719315e7 --- /dev/null +++ b/doc/soundapi-4.html @@ -0,0 +1,268 @@ + + +Advanced Linux Sound Architecture - Library API: Mixer Interface + + +Previous +Next +Table of Contents +
+

4. Mixer Interface

+ +

The Mixer Interface allows applications to change the volume level of +a soundcard's input/output channels in both the linear range (0-100) +and in decibels. It also supports features like hardware mute, input +sound source, etc.

+ +

4.1 Low-Level Layer

+ +

Mixer devices aren't opened exclusively. This allows applications to +open a device multiple times with one or more processes.

+ +

int snd_mixer_open( void **handle, int card, int device )

+ +

Creates new handle and opens a connection to the kernel sound +mixer interface for soundcard number card (0-N) and mixer +device number device. Also checks if protocol is +compatible to prevent use of old programs with new kernel API. Function +returns zero if successful, otherwise it returns an error code.

+ +

int snd_mixer_close( void *handle )

+ +

Frees all resources allocated to the mixer handle and +closes its connection to the kernel sound mixer interface. Function +returns zero if successful, otherwise it returns an error code.

+ +

int snd_mixer_file_descriptor( void *handle )

+ +

Returns the file descriptor for the connection to the kernel sound +mixer interface. This function should be used only in very +special cases. Function returns a negative error code if an +error was encountered.

+

The file descriptor should be used for the select synchronous +multiplexer function for deterimeing read direction. Applications should +call snd_mixer_read function if some data is waiting to be read. +It is recomended that you do this, since it leaves place for this function +to handle some new kernel API specifications.

+ +

int snd_mixer_channels( void *handle )

+ +

Returns the count of mixer channels for appropriate mixer device, otherwise +the return value is negative, and signifies an error code. Never returns +zero.

+ +

int snd_mixer_info( void *handle, snd_mixer_info_t *info )

+ +

Fills the *info structure with information about the mixer associated with +*handle. Returns zero if successful, otherwise it returns an error code. +

+
+  #define SND_MIXER_INFO_CAP_EXCL_RECORD  0x00000001
+
+  struct snd_mixer_info {
+    unsigned int type;            /* type of soundcard - SND_CARD_TYPE_XXXX */
+    unsigned int channels;        /* count of mixer devices */
+    unsigned int caps;            /* some flags about this device (SND_MIXER_INFO_CAP_XXXX) */
+    unsigned char id[32];         /* ID of this mixer */
+    unsigned char name[80];       /* name of this device */
+    char reserved[ 32 ];          /* reserved for future use */
+  };
+  
+
+
+

+ +

int snd_mixer_channel( void *handle, const char *channel_id )

+ +

Returns the channel number (index) associated with channel_id (channel name), +or returns an error code. +

+
+  #define SND_MIXER_ID_MASTER             "Master"
+  #define SND_MIXER_ID_BASS               "Bass"
+  #define SND_MIXER_ID_TREBLE             "Treble"
+  #define SND_MIXER_ID_SYNTHESIZER        "Synth"
+  #define SND_MIXER_ID_SYNTHESIZER1       "Synth 1"
+  #define SND_MIXER_ID_FM                 "FM"
+  #define SND_MIXER_ID_EFFECT             "Effect"
+  #define SND_MIXER_ID_PCM                "PCM"
+  #define SND_MIXER_ID_PCM1               "PCM 1"
+  #define SND_MIXER_ID_LINE               "Line-In"
+  #define SND_MIXER_ID_MIC                "MIC"
+  #define SND_MIXER_ID_CD                 "CD"
+  #define SND_MIXER_ID_GAIN               "Record-Gain"
+  #define SND_MIXER_ID_IGAIN              "In-Gain"
+  #define SND_MIXER_ID_OGAIN              "Out-Gain"
+  #define SND_MIXER_ID_LOOPBACK           "Loopback"
+  #define SND_MIXER_ID_SPEAKER            "PC Speaker"
+  #define SND_MIXER_ID_AUXA               "Aux A"
+  #define SND_MIXER_ID_AUXB               "Aux B"
+  #define SND_MIXER_ID_AUXC               "Aux C"
+  
+
+
+

+ +

int snd_mixer_exact_mode( void *handle, int enable )

+ +

Turns on or off (by default) exact mode. This mode allows to application +set/get volume values in exact range which uses hardware. In non-exact +mode is range always from 0 to 100 and conversion to hardware range does +driver. Function returns zero if successful, otherwise it returns an error +code.

+ +

int snd_mixer_channel_info( void *handle, int channel, snd_mixer_channel_info_t *info )

+ +

Fills the *info structure. The argument channel specifies channel +(0 to N) for which is the info requested. Function returns zero if +successful, otherwise it returns an error code. +

+
+  #define SND_MIXER_CINFO_CAP_RECORD      0x00000001
+  #define SND_MIXER_CINFO_CAP_STEREO      0x00000002
+  #define SND_MIXER_CINFO_CAP_MUTE        0x00000004
+  #define SND_MIXER_CINFO_CAP_HWMUTE      0x00000008      /* channel supports hardware mute */
+  #define SND_MIXER_CINFO_CAP_DIGITAL     0x00000010      /* channel does digital (not analog) mixing */
+  #define SND_MIXER_CINOF_CAP_INPUT       0x00000020      /* input channel */
+
+  struct snd_mixer_channel_info {
+    unsigned int channel;         /* channel # (filled by application) */
+    unsigned int parent;          /* parent channel # or SND_MIXER_PARENT */
+    unsigned char name[12];       /* name of this device */
+    unsigned int caps;            /* some flags about this device (SND_MIXER_CINFO_XXXX) */
+    int min;                      /* min. value when exact mode (or always 0) */
+    int max;                      /* max. value when exact mode (or always 100) */
+    int min_dB;                   /* minimum decibel value (*100) */
+    int max_dB;                   /* maximum decibel value (*100) */
+    int step_dB;                  /* step decibel value (*100) */
+    unsigned char reserved[16];
+  };
+  
+
+
+

+ +

int snd_mixer_channel_read( void *handle, int channel, snd_mixer_channel_t *data )

+ +

Fills the *data structure. The argument channel specifies +the channel (0 to N) for which is data requested. Function returns +zero if successful, otherwise it returns an error code. +

+
+  #define SND_MIXER_FLG_RECORD            0x00000001      /* channel record source flag */
+  #define SND_MIXER_FLG_MUTE_LEFT         0x00010000
+  #define SND_MIXER_FLG_MUTE_RIGHT        0x00020000
+  #define SND_MIXER_FLG_MUTE              0x00030000
+  #define SND_MIXER_FLG_DECIBEL           0x40000000
+  #define SND_MIXER_FLG_FORCE             0x80000000
+
+  struct snd_mixer_channel {
+    unsigned int channel;         /* channel # (filled by application) */
+    unsigned int flags;           /* some flags to read/write (SND_MIXER_FLG_XXXX) */
+    int left;                     /* min - max when exact mode (or 0 - 100) */
+    int right;                    /* min - max when exact mode (or 0 - 100) */
+    int left_dB;                  /* dB * 100 */
+    int right_dB;                 /* dB * 100 */
+    unsigned char reserved[16];
+  };
+  
+
+
+

+

+

+
SND_MIXER_FLG_RECORD

Record source flag.

+
SND_MIXER_FLG_DECIBEL

If this bit is set, driver set volume from dB variables left_dB +and right_dB.

+
SND_MIXER_FLG_FORCE

Force set - this bit shouldn't be used from user space. Reserved for +kernel.

+
+

+ +

int snd_mixer_channel_write( void *handle, int channel, snd_mixer_channel_t *data )

+ +

Writes the *data structure to kernel. The channel argument +specifies the channel (0 to N) for which is data is to be applied. +Function returns zero if successful, otherwise it returns an error code. +This functions is the opposite of snd_mixer_channel_read.

+ +

int snd_mixer_special_read( void *handle, snd_mixer_special_t *special )

+ +

Not documented...

+ +

int snd_mixer_special_write( void *handle, snd_mixer_special_t *special )

+ +

Not documented...

+ +

int snd_mixer_read( void *handle, snd_mixer_callbacks_t *callbacks )

+ +

This function reads and parses data from driver. Parsed actions are returned +back to the application using the callbacks structure. Applications +should not parse data from the driver in standard cases. This function +returns immediately after all data is read from driver. Does not +block process. +

+
+  typedef struct snd_mixer_callbacks {
+    void *private_data;           /* should be used by application */
+    void (*channel_was_changed)( void *private_data, int channel );
+    void *reserved[15];           /* reserved for future use - must be NULL!!! */
+  } snd_mixer_callbacks_t;
+  
+
+
+

+ + +

4.2 Examples

+ +

The following example shows installed mixer channels for soundcard #0 and +mixer device #0 in the system, and also sets the master volume (if present) +to 50.

+

+

+
+
+int card = 0, device = 0, err;
+void *handle;
+snd_mixer_info_t info;
+snd_mixer_channel_t channel;
+
+if ( (err = snd_mixer_open( &handle, card, device )) < 0 ) {
+  fprintf( stderr, "open failed: %s\n", snd_strerror( err ) );
+  return;
+}
+if ( (err = snd_mixer_info( handle, &info )) < 0 ) {
+  fprintf( stderr, "info failed: %s\n", snd_strerror( err ) );
+  snd_mixer_close( handle );
+  return;
+}
+printf( "Installed MIXER channels for card #i and device %i: %i\n",
+                                        card + 1, device, info.channels );
+master = snd_mixer_channel( handle, SND_MIXER_ID_MASTER );
+if ( master >= 0 ) {
+  if ( (err = snd_mixer_read( handle, master, &channel )) < 0 ) {
+    fprintf( stderr, "master read failed: %s\n", snd_strerror( err ) );
+    snd_mixer_close( handle );
+    return;
+  }
+  channel -> left = channel -> right = 50;
+  if ( (err = snd_mixer_write( handle, master, &channel )) < 0 ) {
+    fprintf( stderr, "master write failed: %s\n", snd_strerror( err ) );
+    snd_mixer_close( handle );
+    return;
+  }
+}
+snd_mixer_close( handle );
+
+
+
+

+ + +
+Previous +Next +Table of Contents + + diff --git a/doc/soundapi-5.html b/doc/soundapi-5.html new file mode 100644 index 00000000..4cfb17d3 --- /dev/null +++ b/doc/soundapi-5.html @@ -0,0 +1,552 @@ + + +Advanced Linux Sound Architecture - Library API: Digital Audio (PCM) Interface + + +Previous +Next +Table of Contents +
+

5. Digital Audio (PCM) Interface

+ +

Digital audio is the most commonly used method of representing sound inside +a computer. In this method sound is stored as a sequence of samples taken +from the audio signal using constant time intervals. A sample represents +volume of the signal at the moment when it was measured. In uncompressed +digital audio each sample require one or more bytes of storage. The number of +bytes required depends on number of channels (mono, stereo) and sample +format (8 or 16 bits, mu-Law, etc.). The length of this interval determines +the sampling rate. Commonly used sampling rates are between 8 kHz (telephone +quality) and 48 kHz (DAT tapes).

+

The physical devices used in digital audio are called the ADC (Analog to +Digital Converter) and DAC (Digital to Analog Converter). A device containing +both ADC and DAC is commonly known as a codec. The codec device used in +a Sound Blaster cards is called a DSP which is somewhat misleading since DSP +also stands for Digital Signal Processor (the SB DSP chip is very limited +when compared to "true" DSP chips).

+

Sampling parameters affect the quality of sound which can be reproduced from +the recorded signal. The most fundamental parameter is sampling rate which +limits the highest frequency than can be stored. It is well known (Nyquist's +Sampling Theorem) that the highest frequency that can be stored in a sampled +signal is at most 1/2 of the sampling frequency. For example, a 8 kHz sampling +rate permits the recording of a signal in which the highest frequency is less +than 4 kHz. Higher frequency signals must be filtered out before feeding them +to DAC.

+

Sample encoding limits the dynamic range of recorded signal (difference between +the faintest and the loudest signal that can be recorded). In theory the +maximum dynamic range of signal is number_of_bits * 6 dB . This means that +8 bits sampling resolution gives dynamic range of 48 dB and 16 bit resolution +gives 96 dB.

+

Quality has price. The number of bytes required to store an audio sequence +depends on sampling rate, number of channels and sampling resolution. For +example just 8000 bytes of memory is required to store one second of sound +using 8 kHz/8 bits/mono but 48 kHz/16bit/stereo takes 192 kilobytes. A 64 kbps +ISDN channel is required to transfer a 8kHz/8bit/mono audio stream in real +time, and about 1.5 Mbps is required for DAT quality (48kHz/16bit/stereo). +On the other hand it is possible to store just 5.46 seconds of sound in +a megabyte of memory when using 48kHz/16bit/stereo sampling. With +8kHz/8bits/mono it is possible to store 131 seconds of sound using the same +amount of memory. It is possible to reduce memory and communication costs by +compressing the recorded signal but this is out of the scope of this document.

+ +

5.1 Low-Level Layer

+ +

Audio devices are opened exclusively for a selected direction. This doesn't +allow open from more than one processes for the same audio device in the +same direction, but does allow one open call to each playback direction and +second open call to record direction independently. Audio devices return +EBUSY error to applications when other applications have already opened the +requested direction.

+

Low-Level layer supports these formats: +

+
+
+#define SND_PCM_SFMT_MU_LAW             0
+#define SND_PCM_SFMT_A_LAW              1
+#define SND_PCM_SFMT_IMA_ADPCM          2
+#define SND_PCM_SFMT_U8                 3
+#define SND_PCM_SFMT_S16_LE             4
+#define SND_PCM_SFMT_S16_BE             5
+#define SND_PCM_SFMT_S8                 6
+#define SND_PCM_SFMT_U16_LE             7
+#define SND_PCM_SFMT_U16_BE             8
+#define SND_PCM_SFMT_MPEG               9
+#define SND_PCM_SFMT_GSM                10
+
+#define SND_PCM_FMT_MU_LAW              (1 << SND_PCM_SFMT_MU_LAW)
+#define SND_PCM_FMT_A_LAW               (1 << SND_PCM_SFMT_A_LAW)
+#define SND_PCM_FMT_IMA_ADPCM           (1 << SND_PCM_SFMT_IMA_ADPCM)
+#define SND_PCM_FMT_U8                  (1 << SND_PCM_SFMT_U8)
+#define SND_PCM_FMT_S16_LE              (1 << SND_PCM_SFMT_S16_LE)
+#define SND_PCM_FMT_S16_BE              (1 << SND_PCM_SFMT_S16_BE)
+#define SND_PCM_FMT_S8                  (1 << SND_PCM_SFMT_S8)
+#define SND_PCM_FMT_U16_LE              (1 << SND_PCM_SFMT_U16_LE)
+#define SND_PCM_FMT_U16_BE              (1 << SND_PCM_SFMT_U16_BE)
+#define SND_PCM_FMT_MPEG                (1 << SND_PCM_SFMT_MPEG)
+#define SND_PCM_FMT_GSM                 (1 << SND_PCM_SFMT_GSM)
+
+
+
+ +Constants with prefix SND_PCM_FMT_ are used in info structures +and constants with prefix SND_PCM_SFMT_ are used in format structures.

+ +

int snd_pcm_open( void **handle, int card, int device, int mode )

+ +

Creates a new handle and opens a connection to kernel sound +audio interface for soundcard number card (0-N) and audio +device number device. Function also checks if protocol is +compatible to prevent use of old programs with a new kernel API. Function +returns zero if successful,ful otherwise it returns an error code. +Error code -EBUSY is returned when some process ownes the selected direction.

+

Default format after opening is mono mu-Law at 8000Hz. This device +can be used directly for playback of standard .au (Sparc) files.

+

The following modes should be used for the mode argument: +

+
+  #define SND_PCM_OPEN_PLAYBACK   (O_WRONLY)
+  #define SND_PCM_OPEN_RECORD     (O_RDONLY)
+  #define SND_PCM_OPEN_DUPLEX     (O_RDWR)
+  
+
+
+

+ +

int snd_pcm_close( void *handle )

+ +

Frees all resources allocated with audio handle and +closes the connection to the kernel sound audio interface. Function +returns zero if successful, otherwise it returns an error code.

+ +

int snd_pcm_file_descriptor( void *handle )

+ +

Returns the file descriptor of the connection to the kernel sound +audio interface. Function returns an error code if an +error was encountered.

+

The file descriptor should be used for the select synchronous +multiplexer function for setting the read direction. Application should +call snd_pcm_read or snd_pcm_write functions if some +data is waiting for reading or a write can be performed. Calling this +function is highly recomended, as it leaves a place for the API to things +like data conversions, if needed.

+ +

int snd_pcm_block_mode( void *handle, int enable )

+ +

Sets up block (default) or nonblock mode for a handle. Block mode suspends +execution of a program when snd_pcm_read or snd_pcm_write +is called for the time which is needed for the actual playback or record +over of the entire buffer. In nonblock mode, programs aren't suspended and +the above functions returns immediately with the count of bytes which were +read or written by the driver. When used in this way, don't try to use the +entire buffer after the call, but instead process the number of bytes +returned, and call the function again.

+ +

int snd_pcm_info( void *handle, snd_pcm_info_t *info )

+ +

Fills the *info structure with data about the PCM device selected by +*handle. Function returns zero if successful, otherwise it returns +an error code. +

+
+  #define SND_PCM_INFO_CODEC              0x00000001
+  #define SND_PCM_INFO_DSP                SND_PCM_INFO_CODEC
+  #define SND_PCM_INFO_MMAP               0x00000002      /* reserved */
+  #define SND_PCM_INFO_PLAYBACK           0x00000100
+  #define SND_PCM_INFO_RECORD             0x00000200
+  #define SND_PCM_INFO_DUPLEX             0x00000400
+  #define SND_PCM_INFO_DUPLEX_LIMIT       0x00000800      /* rate for playback & record are same */
+
+  struct snd_pcm_info {
+    unsigned int type;                    /* soundcard type */
+    unsigned int flags;                   /* see SND_PCM_INFO_XXXX */
+    unsigned char id[32];                 /* ID of this PCM device */
+    unsigned char name[80];               /* name of this device */
+    unsigned char reserved[64];           /* reserved for future use */
+  };
+  
+
+
+ +
+
SND_PCM_INFO_MMAP

This flag is reserved and should be never used. It remains for +compatibility with Open Sound System driver.

+
SND_PCM_INFO_DUPLEX_LIMIT

If this bit is set, rate must be same for playback and record direction.

+
+

+ +

int snd_pcm_playback_info( void *handle, snd_pcm_playback_info_t *info )

+ +

Fills the *info structure with data about PCM playback. Function returns +zero if successful, otherwise it returns an error code. +

+
+  #define SND_PCM_PINFO_BATCH             0x00000001
+  #define SND_PCM_PINFO_8BITONLY          0x00000002
+  #define SND_PCM_PINFO_16BITONLY         0x00000004
+
+  struct snd_pcm_playback_info {
+    unsigned int flags;                   /* see SND_PCM_PINFO_XXXX */
+    unsigned int formats;                 /* supported formats */
+    unsigned int min_rate;                /* min rate (in Hz) */
+    unsigned int max_rate;                /* max rate (in Hz) */
+    unsigned int min_channels;            /* min channels (probably always 1) */
+    unsigned int max_channels;            /* max channels */
+    unsigned int buffer_size;             /* playback buffer size */
+    unsigned int min_fragment_size;       /* min fragment size in bytes */
+    unsigned int max_fragment_size;       /* max fragment size in bytes */
+    unsigned int fragment_align;          /* align fragment value */
+    unsigned char reserved[64];           /* reserved for future use */
+  };
+  
+
+
+ +
+
SND_PCM_PINFO_BATCH

Driver implements double buffering with this device. This means that +the chip used for data processing has its own memory, and output should be +more delayed than if a traditional codec chip is used.

+
SND_PCM_PINFO_8BITONLY

If this bit is set, the driver uses 8-bit format for 16-bit samples and +does software conversion. This bit is set on broken SoundBlaster 16/AWE +soundcards which can't do full 16-bit duplex. If this bit is set +application or highter digital audio layer should do the conversion from +16-bit samples to 8-bit samples rather than making the driver to do it in +the kernel.

+
SND_PCM_PINFO_16BITONLY

If this bit is set, driver uses 16-bit format for 8-bit samples and +does software conversion. This bit is set on broken SoundBlaster 16/AWE +soundcards which can't do full 8-bit duplex. If this bit is set the +application or highter digital audio layer should do conversion from +8-bit samples to 16-bit samples rather than making the driver to do it in +the kernel.

+
+

+ +

int snd_pcm_record_info( void *handle, snd_pcm_record_info_t *info )

+ +

Fills the *info structure. Returns zero if successful, otherwise it returns +an error code. +

+
+  #define SND_PCM_RINFO_BATCH             0x00000001
+  #define SND_PCM_RINFO_8BITONLY          0x00000002
+  #define SND_PCM_RINFO_16BITONLY         0x00000004
+
+  struct snd_pcm_record_info {
+    unsigned int flags;                   /* see to SND_PCM_RINFO_XXXX */
+    unsigned int formats;                 /* supported formats */
+    unsigned int min_rate;                /* min rate (in Hz) */
+    unsigned int max_rate;                /* max rate (in Hz) */
+    unsigned int min_channels;            /* min channels (probably always 1) */
+    unsigned int max_channels;            /* max channels */
+    unsigned int buffer_size;             /* record buffer size */
+    unsigned int min_fragment_size;       /* min fragment size in bytes */
+    unsigned int max_fragment_size;       /* max fragment size in bytes */
+    unsigned int fragment_align;          /* align fragment value */
+    unsigned char reserved[64];           /* reserved for future... */
+  };
+  
+
+
+ +
+
SND_PCM_PINFO_BATCH

Driver implements buffering for this device. This means that +the chip used for data processing has its own memory and output should be +more delayed than if a traditional codec chip is used.

+
SND_PCM_PINFO_8BITONLY

If this bit is set, the device uses 8-bit format for 16-bit samples and +does software conversion. This bit is set on broken SoundBlaster 16/AWE +soundcards which can't do full 16-bit duplex. If this bit is set the +application or highter digital audio layer should do conversion from +16-bit samples to 8-bit samples rather than making the driver to do it in +the kernel.

+
SND_PCM_PINFO_16BITONLY

If this bit is set, the device uses a 16-bit format for 8-bit samples and +does software conversion. This bit is set on broken SoundBlaster 16/AWE +soundcards which can't do full 8-bit duplex. If this bit is set the +application or highter digital audio layer should do the conversion from +8-bit samples to 16-bit samples rather than making the driver to do it in +the kernel.

+
+

+ +

int snd_pcm_playback_format( void *handle, snd_pcm_format_t *format )

+ +

Sets up format, rate (in Hz) and number of channels for playback, in the +desired direction. Function returns zero if successful, otherwise it +returns an error code. +

+
+  struct snd_pcm_format {
+    unsigned int format;                  /* SND_PCM_SFMT_XXXX */
+    unsigned int rate;                    /* rate in Hz */
+    unsigned int channels;                /* channels (voices) */
+    unsigned char reserved[16];
+  };
+  
+
+
+

+ +

int snd_pcm_record_format( void *handle, snd_pcm_format_t *format )

+ +

Sets up format, rate (in Hz) and number of channels for used for recording +in the specified direction. Function returns zero if successful, otherwise +it returns an error code. +

+
+  struct snd_pcm_format {
+    unsigned int format;                  /* SND_PCM_SFMT_XXXX */
+    unsigned int rate;                    /* rate in Hz */
+    unsigned int channels;                /* channels (voices) */
+    unsigned char reserved[16];
+  };
+  
+
+
+

+ +

int snd_pcm_playback_params( void *handle, snd_pcm_playback_params_t *params )

+ +

Sets various parameters for playback direction. Function returns zero if +successful, otherwise it returns an error code. +

+
+  struct snd_pcm_playback_params {
+    int fragment_size;
+    int fragments_max;
+    int fragments_room;
+    unsigned char reserved[16];           /* must be filled with zero */
+  };
+  
+
+
+ +
+
fragment_size

Requested size of fragment. This value should be aligned for current +format (for example to 4 if stereo 16-bit samples are used) or with the +fragment_align variable from snd_pcm_playback_info_t +structure. Its range can be from min_fragment_size to +max_fragment_size.

+
fragments_max

Maximum number of fragments in queue for wakeup. This number doesn't +counts partly used fragment. If current count of filled playback fragments +is greater than this value driver block application or return immediately +back if nonblock mode is active.

+
fragments_room

Minumum number of fragments writeable for wakeup. This value should be +in most cases 1 which means return back to application if at least +one fragment is free for playback. This value includes partly used fragments, +too.

+
+

+ +

int snd_pcm_record_params( void *handle, snd_pcm_record_params_t *params )

+ +

Function sets various parameters for the recording direction. Function returns +zero if successful, otherwise it returns an error code. +

+
+  struct snd_pcm_record_params {
+    int fragment_size;
+    int fragments_min;
+    unsigned char reserved[16];
+  };
+  
+
+
+ +
+
fragment_size

Requested size of fragment. This value should be aligned for current +format (for example to 4 if stereo 16-bit samples are used) or set to the +fragment_align variable from snd_pcm_playback_info_t +structure. Its range can be from min_fragment_size to +max_fragment_size.

+
fragments_min

Minimum filled fragments for wakeup. Driver blocks the application (if +block mode is selected) until it isn't filled with number of fragments +specified with this value.

+
+

+ +

int snd_pcm_playback_status( void *handle, snd_pcm_playback_status_t *status )

+ +

Fills the *status structure. Function returns zero if successful, otherwise +it returns an error code. +

+
+  struct snd_pcm_playback_status {
+    unsigned int rate;
+    int fragments;
+    int fragment_size;
+    int count;
+    int queue;
+    int underrun;
+    struct timeval time;
+    struct timeval stime;
+    unsigned char reserved[16];
+  };
+  
+
+
+ +
+
rate

Real playback rate. This value reflects hardware limitations.

+
fragments

Currently allocated fragments by the driver for playback direction.

+
fragment_size

Current fragment size used by driver for the playback direction.

+
count

Count of bytes writeable without blocking.

+
queue

Count of bytes in queue. Note: (fragments * fragment_size) - queue +should not be equal to count.

+
underrun

This value tells the application the number of underruns since the ast call +of snd_pcm_playback_status.

+
time

Delay till played of the first sample from next write. This value should +be used for time synchronization. Returned value is in the same format as +returned from the standard C function gettimeofday( &time, NULL ). +This variable contains right value only if playback time mode is enabled +(look to snd_pcm_playback_time function).

+
stime

Time when playback was started. +This variable contains right value only if playback time mode is enabled +(look to snd_pcm_playback_time function).

+
+

+ +

int snd_pcm_record_status( void *handle, snd_pcm_record_status_t *status )

+ +

Fills the *status structure. Function returns zero if successful, otherwise +it returns an error code. +

+
+  struct snd_pcm_record_status {
+    unsigned int rate;
+    int fragments;
+    int fragment_size;
+    int count;
+    int free;
+    int overrun;
+    struct timeval time;
+    unsigned char reserved[16];
+  };
+  
+
+
+ +
+
rate

Real record rate. This value reflects hardware limitations.

+
fragments

Currently allocated fragments by driver for the record direction.

+
fragment_size

Current fragment size used by driver for the record direction.

+
count

Count of bytes readable without blocking.

+
free

Count of bytes in buffer still free. Note: (fragments * fragment_size) - free +should not be equal to count.

+
overrun

This value tells application the count of overruns since the last call +to snd_pcm_record_status.

+
time

Lag since the next sample read was recorded. This value should be used for time +synchronization. Returned value is in the same format as returned by the +from standard C function gettimeofday( &time, NULL ). This +variable contains right value only if record time mode is enabled (look to +snd_pcm_record_time function).

+
stime

Time when record was started. This variable contains right value only if +record time mode is enabled (look to snd_pcm_record_time function).

+
+

+ +

int snd_pcm_drain_playback( void *handle )

+ +

This function drain playback buffers immediately. Function returns zero +if successful, otherwise it returns an error code.

+ +

int snd_pcm_flush_playback( void *handle )

+ +

This function flushes the playback buffers. It blocks the program while the +all the waiting samples in kernel playback buffers are processed. Function +returns zero if successful, otherwise it returns an error code.

+ +

int snd_pcm_flush_record( void *handle )

+ +

This function flushes (destroyes) record buffers. Function returns zero +if successful, otherwise it returns an error code.

+ +

int snd_pcm_playback_time( void *handle, int enable )

+ +

This function enables or disables time mode for playback direction. Time mode +allows to application better time synchronization. Function returns zero +if successful, otherwise it returns an error code.

+ +

int snd_pcm_record_time( void *handle, int enable )

+ +

This function enables or disables time mode for record direction. Time mode +allows to application better time synchronization. Function returns zero +if successful, otherwise it returns an error code.

+ +

ssize_t snd_pcm_write( void *handle, const void *buffer, size_t size )

+ +

Writes samples to the device which must be in the proper format +specified by the snd_pcm_playback_format function. Function +returns zero or positive value if playback was successful (value represents +count of bytes which was successfuly written to device) or an +error value if error occured. Function should suspend process if +block mode is active.

+ +

ssize_t snd_pcm_read( void *handle, void *buffer, size_t size )

+ +

Function reads samples from driver. Samples are in format specified +by snd_pcm_record_format function. Function returns zero +or positive value if record was success (value represents count of bytes +which was successfuly read from device) or negative error value if +error occured. Function should suspend process if block mode is active.

+ + +

5.2 Examples

+ +

The following example shows how to play the first 512kB from the +/tmp/test.au file with soundcard #0 and PCM device #0:

+

+

+
+
+int card = 0, device = 0, err, fd, count, size, idx;
+void *handle;
+snd_pcm_format_t format;
+char *buffer;
+
+buffer = (char *)malloc( 512 * 1024 );
+if ( !buffer ) return;
+if ( (err = snd_pcm_open( &handle, card, device, SND_PCM_OPEN_PLAYBACK )) < 0 ) {
+  fprintf( stderr, "open failed: %s\n", snd_strerror( err ) );
+  return;
+}
+format.format = SND_PCM_SFMT_MU_LAW;
+format.rate = 8000;
+format.voices = 1;
+if ( (err = snd_pcm_playback_format( handle, &format )) < 0 ) {
+  fprintf( stderr, "format setup failed: %s\n", snd_strerror( err ) );
+  snd_pcm_close( handle );
+  return;
+}
+fd = open( "/tmp/test.au" );
+if ( fd < 0 ) {
+  perror( "open file" );
+  snd_pcm_close( handle );
+  return;
+}
+idx = 0;
+count = read( fd, buffer, 512 * 1024 );
+if ( count <= 0 ) {
+  perror( "read from file" );
+  snd_pcm_close( handle );
+  return;
+}
+close( fd );
+if ( !memcmp( buffer, ".snd", 4 ) ) {
+  idx = (buffer[4]<<24)|(buffer[5]<<16)|(buffer[6]<<8)|(buffer[7]);
+  if ( idx > 128 ) idx = 128;
+  if ( idx > count ) idx = count;
+}
+size = snd_pcm_write( handle, &buffer[ idx ], count - idx );
+printf( "Bytes written %i from %i...\n", size, count - idx );
+snd_pcm_close( handle );
+free( buffer );
+
+
+
+

+ + +
+Previous +Next +Table of Contents + + diff --git a/doc/soundapi.html b/doc/soundapi.html new file mode 100644 index 00000000..ac5edcd4 --- /dev/null +++ b/doc/soundapi.html @@ -0,0 +1,52 @@ + + + +Advanced Linux Sound Architecture - Library API + + +Previous +Next +Table of Contents +
+

Advanced Linux Sound Architecture - Library API

+ +

Jaroslav Kysela <perex@jcu.cz> with assistance from Alan Robinson

v0.0.3, 25 March 1998 +

This document describes, in full detail, the Advanced Linux Sound Architecture library API.

+

+

1. Introduction

+ +

+

2. Error Codes

+ + +

+

3. Control Interface

+ + +

+

4. Mixer Interface

+ + +

+

5. Digital Audio (PCM) Interface

+ + + +
+Previous +Next +Table of Contents + + diff --git a/doc/soundapi.sgml b/doc/soundapi.sgml new file mode 100644 index 00000000..bf32ebc3 --- /dev/null +++ b/doc/soundapi.sgml @@ -0,0 +1,956 @@ + + + + +
+ + + +Advanced Linux Sound Architecture - Library API +<author>Jaroslav Kysela <tt><perex@jcu.cz></tt> with assistance from Alan Robinson +<date>v0.0.3, 25 March 1998 +<abstract> +This document describes, in full detail, the Advanced Linux Sound +Architecture library API. +</abstract> + +<!-- Table of contents --> +<toc> + +<!-- Begin the document --> + +<sect>Introduction + +<p> +The Advanced Linux Sound Architecture comes with a kernel API & library API. +This document describes the library API and how it interfaces with the kernel +API. The kernal API will probably never be documented in standalone form. +<P> +Application programmers should use the library API rather than kernel API. +The Library offers 100% of the functionally of the kernel API, but add next +major improvements in usability, making the application code simpler and +better looking. In addition, some of the some fixes/compatibility code in, +may be placed in the library code instead of the kernel driver. +<p> +For a complete list of all variables and functions in the API you should look +at the following header files: +<enum> + <item>/usr/include/sys/soundlib.h + <item>/usr/include/linux/sound.h + <item>/usr/include/linux/sounddetect.h +</enum> + +<sect>Error Codes + +<p> +All functions return int (or some sort of signed value). If this value +is negative it represents an error code. Codes up to SND_ERROR_BEGIN (500000) +represents standard system errors. Codes equal or greather than this value +represents sound library API errors. All error codes begin with the prefix +<it>SND_ERROR_</it>. + +<sect1>Error Codes in Detail + +<p> +<descrip> +<tag>SND_ERROR_UNCOMPATIBLE_VERSION (500000)</tag> + This error is caused if the driver uses an incompatible kernel API for this + interface and hence the library doesn't know how this API can be used. +</descrip> + +<sect1>Functions + +<p> + +<sect2>const char *snd_strerror( int errnum ) + <p> + This functions converts error code to a string. Its functionality is the same + as the <it>strerror</it> function from the standard C library, but this + function returns correct strings for sound error codes, too. + +<sect>Control Interface + +<p> +The control interfaces gives application various information about the +currently installed sound driver in the system. The interface should be used +to detect if another sound interface is present for selected soundcard or, +for example, to create a list of devices (MIXER, PCM etc) from which +the user can select. + +<sect1>Low-Level Layer + +<sect2>int snd_cards( void ) + <p> + Returns the number of soundcards present in the system, if any. Otherwise + it returns a negative value, which maps to an error code. This function + will return 0 if no soundcards are detected. + +<sect2>unsigned int snd_cards_mask( void ) + <p> + Returns the bitmap of soundcards present in the system, if any. Otherwise + it returns a negative value, which maps to an error code. This function + will return 0 if no soundcards are detected. First soundcard is represented + with bit 0. + +<sect2>int snd_ctl_open( void **handle, int card ) + <p> + Creates a new handle and opens communication with the kernel sound + control interface for soundcard number <it>card</it> (0-N). The function + also checks if protocol is compatible, so as to prevent the use of old + programs with a new kernel API. Function returns zero if successful, + otherwise an error code is returned. + +<sect2>int snd_ctl_close( void *handle ) + <p> + Function frees all resources allocated with control handle and + closes the kernel sound control interface. Function returns zero if + successful, otherwise it returns an error code. + +<sect2>int snd_ctl_file_descriptor( void *handle ) + <p> + Function returns file descriptor for the kernel sound control interface. + This function should be used in very special cases. Function returns + a negative error code if some error was encountered. + +<sect2>int snd_ctl_hw_info( void *handle, struct snd_ctl_hw_info *info ) + <p> + Fills the info structure with data about the sound hardware referenced + by handle. Function returns zero if successful, otherwise it returns + an error code. + <code> + #define SND_CTL_GCAPS_MIDI 0x0000001 /* driver has MIDI interface */ + + #define SND_CTL_LCAPS_SYNTH 0x0000001 /* soundcard has synthesizer */ + #define SND_CTL_LCAPS_RAWFM 0x0000002 /* soundcard has RAW FM/OPL3 */ + + struct snd_ctl_hw_info { + unsigned int type; /* type of card - see SND_CARD_TYPE_XXXX */ + unsigned int gcaps; /* see SND_CTL_GCAPS_XXXX */ + unsigned int lcaps; /* see SND_CTL_LCAPS_XXXX */ + unsigned int pcmdevs; /* count of PCM devices (0 to N) */ + unsigned int mixerdevs; /* count of MIXER devices (0 to N) */ + unsigned int mididevs; /* count of raw MIDI devices (0 to N) */ + char id[8]; /* ID of card (user selectable) */ + char name[80]; /* name/info text about soundcard */ + unsigned char reserved[128]; /* reserved for future use */ + }; + </code> + +<sect2>int snd_ctl_pcm_info( void *handle, int dev, snd_pcm_info_t *info ) + <p> + Fills the *info structure with data about the PCM device. Function returns + zero if successful, otherwise it returns an error code. Details about + the snd_pcm_info_t structure are in the <bf>Digital Audio (PCM) Interface</bf> + section. The argument <it>dev</it> selects the device number for the + soundcard referenced by *handle. Its range is 0 to N where N is + <it>struct snd_ctl_hw_info -> pcmdevs - 1</it>. This function will work if + the selected PCM device is busy, too. It should be used to collect + information about PCM devices without exclusive lock. + +<sect2>int snd_ctl_pcm_playback_info( void *handle, int dev, snd_pcm_playback_info_t *info ) + <p> + Fills the *info structure with data about the PCM device and playback direction. + Function returns zero if successful, otherwise it returns an error code. + Details about the snd_pcm_playback_info_t structure are in the + <bf>Digital Audio (PCM) Interface</bf> section. The argument <it>dev</it> + selects the device number for the soundcard referenced by *handle. Its + range is 0 to N where N is <it>struct snd_ctl_hw_info -> pcmdevs - 1</it>. + This function will work if the selected PCM device is busy, too. It should + be used to collect information about PCM devices without exclusive lock. + +<sect2>int snd_ctl_pcm_record_info( void *handle, int dev, snd_pcm_record_info_t *info ) + <p> + Fills the *info structure with data about the PCM device and record direction. + Function returns zero if successful, otherwise it returns an error code. + Details about the snd_pcm_record_info_t structure are in the + <bf>Digital Audio (PCM) Interface</bf> section. The argument <it>dev</it> + selects the device number for the soundcard referenced by *handle. Its + range is 0 to N where N is <it>struct snd_ctl_hw_info -> pcmdevs - 1</it>. + This function will work if the selected PCM device is busy, too. It should + be used to collect information about PCM devices without exclusive lock. + +<sect2>int snd_ctl_mixer_info( void *handle, int dev, snd_mixer_info_t *info ) + <p> + Fills the *info structure with data about the mixer device. Returns zero + if successful, otherwise it returns an error code. Details about the + snd_mixer_info_t structure are in the <bf>Mixer Interface</bf> section. + The argument <it>dev</it> specifies the device number for the appropriate + soundcard. Its range is 0 to N where N found from + <it>struct snd_ctl_hw_info -> mixerdevs - 1</it>. + It should be used to collect information about mixer devices. + +<sect1>Examples + +<p> +The following example shows how all PCM devices can be detected for the first +soundcard (#0) in the system. + +<tscreen><code> +int card = 0, err; +void *handle; +stuct snd_ctl_hw_info info; + +if ( (err = snd_ctl_open( &ero;handle, card )) < 0 ) { + fprintf( stderr, "open failed: %s\n", snd_strerror( err ) ); + return; +} +if ( (err = snd_ctl_hw_info( handle, &ero;info )) < 0 ) { + fprintf( stderr, "hw info failed: %s\n", snd_strerror( err ) ); + snd_ctl_close( handle ); + return; +} +printf( "Installed PCM devices for card #i: %i\n", card + 1, info.pcmdevs ); +snd_ctl_close( handle ); +</code></tscreen> + +<sect>Mixer Interface + +<p> +The Mixer Interface allows applications to change the volume level of +a soundcard's input/output channels in both the linear range (0-100) +and in decibels. It also supports features like hardware mute, input +sound source, etc. + +<sect1>Low-Level Layer + +<p> +Mixer devices aren't opened exclusively. This allows applications to +open a device multiple times with one or more processes. + +<sect2>int snd_mixer_open( void **handle, int card, int device ) + <p> + Creates new handle and opens a connection to the kernel sound + mixer interface for soundcard number <it>card</it> (0-N) and mixer + device number <it>device</it>. Also checks if protocol is + compatible to prevent use of old programs with new kernel API. Function + returns zero if successful, otherwise it returns an error code. + +<sect2>int snd_mixer_close( void *handle ) + <p> + Frees all resources allocated to the mixer handle and + closes its connection to the kernel sound mixer interface. Function + returns zero if successful, otherwise it returns an error code. + +<sect2>int snd_mixer_file_descriptor( void *handle ) + <p> + Returns the file descriptor for the connection to the kernel sound + mixer interface. This function should be used only in very + special cases. Function returns a negative error code if an + error was encountered. + <p> + The file descriptor should be used for the <it>select</it> synchronous + multiplexer function for deterimeing read direction. Applications should + call <it>snd_mixer_read</it> function if some data is waiting to be read. + It is recomended that you do this, since it leaves place for this function + to handle some new kernel API specifications. + +<sect2>int snd_mixer_channels( void *handle ) + <p> + Returns the count of mixer channels for appropriate mixer device, otherwise + the return value is negative, and signifies an error code. Never returns + zero. + +<sect2>int snd_mixer_info( void *handle, snd_mixer_info_t *info ) + <p> + Fills the *info structure with information about the mixer associated with + *handle. Returns zero if successful, otherwise it returns an error code. + <code> + #define SND_MIXER_INFO_CAP_EXCL_RECORD 0x00000001 + + struct snd_mixer_info { + unsigned int type; /* type of soundcard - SND_CARD_TYPE_XXXX */ + unsigned int channels; /* count of mixer devices */ + unsigned int caps; /* some flags about this device (SND_MIXER_INFO_CAP_XXXX) */ + unsigned char id[32]; /* ID of this mixer */ + unsigned char name[80]; /* name of this device */ + char reserved[ 32 ]; /* reserved for future use */ + }; + </code> + +<sect2>int snd_mixer_channel( void *handle, const char *channel_id ) + <p> + Returns the channel number (index) associated with channel_id (channel name), + or returns an error code. + <code> + #define SND_MIXER_ID_MASTER "Master" + #define SND_MIXER_ID_BASS "Bass" + #define SND_MIXER_ID_TREBLE "Treble" + #define SND_MIXER_ID_SYNTHESIZER "Synth" + #define SND_MIXER_ID_SYNTHESIZER1 "Synth 1" + #define SND_MIXER_ID_FM "FM" + #define SND_MIXER_ID_EFFECT "Effect" + #define SND_MIXER_ID_PCM "PCM" + #define SND_MIXER_ID_PCM1 "PCM 1" + #define SND_MIXER_ID_LINE "Line-In" + #define SND_MIXER_ID_MIC "MIC" + #define SND_MIXER_ID_CD "CD" + #define SND_MIXER_ID_GAIN "Record-Gain" + #define SND_MIXER_ID_IGAIN "In-Gain" + #define SND_MIXER_ID_OGAIN "Out-Gain" + #define SND_MIXER_ID_LOOPBACK "Loopback" + #define SND_MIXER_ID_SPEAKER "PC Speaker" + #define SND_MIXER_ID_AUXA "Aux A" + #define SND_MIXER_ID_AUXB "Aux B" + #define SND_MIXER_ID_AUXC "Aux C" + </code> + +<sect2>int snd_mixer_exact_mode( void *handle, int enable ) + <p> + Turns on or off (by default) exact mode. This mode allows to application + set/get volume values in exact range which uses hardware. In non-exact + mode is range always from 0 to 100 and conversion to hardware range does + driver. Function returns zero if successful, otherwise it returns an error + code. + +<sect2>int snd_mixer_channel_info( void *handle, int channel, snd_mixer_channel_info_t *info ) + <p> + Fills the *info structure. The argument <it>channel</it> specifies channel + (0 to N) for which is the info requested. Function returns zero if + successful, otherwise it returns an error code. + <code> + #define SND_MIXER_CINFO_CAP_RECORD 0x00000001 + #define SND_MIXER_CINFO_CAP_STEREO 0x00000002 + #define SND_MIXER_CINFO_CAP_MUTE 0x00000004 + #define SND_MIXER_CINFO_CAP_HWMUTE 0x00000008 /* channel supports hardware mute */ + #define SND_MIXER_CINFO_CAP_DIGITAL 0x00000010 /* channel does digital (not analog) mixing */ + #define SND_MIXER_CINOF_CAP_INPUT 0x00000020 /* input channel */ + + struct snd_mixer_channel_info { + unsigned int channel; /* channel # (filled by application) */ + unsigned int parent; /* parent channel # or SND_MIXER_PARENT */ + unsigned char name[12]; /* name of this device */ + unsigned int caps; /* some flags about this device (SND_MIXER_CINFO_XXXX) */ + int min; /* min. value when exact mode (or always 0) */ + int max; /* max. value when exact mode (or always 100) */ + int min_dB; /* minimum decibel value (*100) */ + int max_dB; /* maximum decibel value (*100) */ + int step_dB; /* step decibel value (*100) */ + unsigned char reserved[16]; + }; + </code> + +<sect2>int snd_mixer_channel_read( void *handle, int channel, snd_mixer_channel_t *data ) + <p> + Fills the *data structure. The argument <it>channel</it> specifies + the channel (0 to N) for which is data requested. Function returns + zero if successful, otherwise it returns an error code. + <code> + #define SND_MIXER_FLG_RECORD 0x00000001 /* channel record source flag */ + #define SND_MIXER_FLG_MUTE_LEFT 0x00010000 + #define SND_MIXER_FLG_MUTE_RIGHT 0x00020000 + #define SND_MIXER_FLG_MUTE 0x00030000 + #define SND_MIXER_FLG_DECIBEL 0x40000000 + #define SND_MIXER_FLG_FORCE 0x80000000 + + struct snd_mixer_channel { + unsigned int channel; /* channel # (filled by application) */ + unsigned int flags; /* some flags to read/write (SND_MIXER_FLG_XXXX) */ + int left; /* min - max when exact mode (or 0 - 100) */ + int right; /* min - max when exact mode (or 0 - 100) */ + int left_dB; /* dB * 100 */ + int right_dB; /* dB * 100 */ + unsigned char reserved[16]; + }; + </code> + <p> + <descrip> + <tag>SND_MIXER_FLG_RECORD</tag> + Record source flag. + <tag>SND_MIXER_FLG_DECIBEL</tag> + If this bit is set, driver set volume from dB variables <it>left_dB</it> + and <it>right_dB</it>. + <tag>SND_MIXER_FLG_FORCE</tag> + Force set - this bit shouldn't be used from user space. Reserved for + kernel. + </descrip> + +<sect2>int snd_mixer_channel_write( void *handle, int channel, snd_mixer_channel_t *data ) + <p> + Writes the *data structure to kernel. The <it>channel</it> argument + specifies the channel (0 to N) for which is data is to be applied. + Function returns zero if successful, otherwise it returns an error code. + This functions is the opposite of <it>snd_mixer_channel_read</it>. + +<sect2>int snd_mixer_special_read( void *handle, snd_mixer_special_t *special ) + <p> + Not documented... + +<sect2>int snd_mixer_special_write( void *handle, snd_mixer_special_t *special ) + <p> + Not documented... + +<sect2>int snd_mixer_read( void *handle, snd_mixer_callbacks_t *callbacks ) + <p> + This function reads and parses data from driver. Parsed actions are returned + back to the application using the <it>callbacks</it> structure. Applications + should not parse data from the driver in standard cases. This function + returns immediately after all data is read from driver. Does not + block process. + <code> + typedef struct snd_mixer_callbacks { + void *private_data; /* should be used by application */ + void (*channel_was_changed)( void *private_data, int channel ); + void *reserved[15]; /* reserved for future use - must be NULL!!! */ + } snd_mixer_callbacks_t; + </code> + +<sect1>Examples + +<p> +The following example shows installed mixer channels for soundcard #0 and +mixer device #0 in the system, and also sets the master volume (if present) +to 50. + +<tscreen><code> +int card = 0, device = 0, err; +void *handle; +snd_mixer_info_t info; +snd_mixer_channel_t channel; + +if ( (err = snd_mixer_open( &ero;handle, card, device )) < 0 ) { + fprintf( stderr, "open failed: %s\n", snd_strerror( err ) ); + return; +} +if ( (err = snd_mixer_info( handle, &ero;info )) < 0 ) { + fprintf( stderr, "info failed: %s\n", snd_strerror( err ) ); + snd_mixer_close( handle ); + return; +} +printf( "Installed MIXER channels for card #i and device %i: %i\n", + card + 1, device, info.channels ); +master = snd_mixer_channel( handle, SND_MIXER_ID_MASTER ); +if ( master >= 0 ) { + if ( (err = snd_mixer_read( handle, master, &ero;channel )) < 0 ) { + fprintf( stderr, "master read failed: %s\n", snd_strerror( err ) ); + snd_mixer_close( handle ); + return; + } + channel -> left = channel -> right = 50; + if ( (err = snd_mixer_write( handle, master, &ero;channel )) < 0 ) { + fprintf( stderr, "master write failed: %s\n", snd_strerror( err ) ); + snd_mixer_close( handle ); + return; + } +} +snd_mixer_close( handle ); +</code></tscreen> + +<sect>Digital Audio (PCM) Interface + +<p> +Digital audio is the most commonly used method of representing sound inside +a computer. In this method sound is stored as a sequence of samples taken +from the audio signal using constant time intervals. A sample represents +volume of the signal at the moment when it was measured. In uncompressed +digital audio each sample require one or more bytes of storage. The number of +bytes required depends on number of channels (mono, stereo) and sample +format (8 or 16 bits, mu-Law, etc.). The length of this interval determines +the sampling rate. Commonly used sampling rates are between 8 kHz (telephone +quality) and 48 kHz (DAT tapes). +<p> +The physical devices used in digital audio are called the ADC (Analog to +Digital Converter) and DAC (Digital to Analog Converter). A device containing +both ADC and DAC is commonly known as a codec. The codec device used in +a Sound Blaster cards is called a DSP which is somewhat misleading since DSP +also stands for Digital Signal Processor (the SB DSP chip is very limited +when compared to "true" DSP chips). +<p> +Sampling parameters affect the quality of sound which can be reproduced from +the recorded signal. The most fundamental parameter is sampling rate which +limits the highest frequency than can be stored. It is well known (Nyquist's +Sampling Theorem) that the highest frequency that can be stored in a sampled +signal is at most 1/2 of the sampling frequency. For example, a 8 kHz sampling +rate permits the recording of a signal in which the highest frequency is less +than 4 kHz. Higher frequency signals must be filtered out before feeding them +to DAC. +<p> +Sample encoding limits the dynamic range of recorded signal (difference between +the faintest and the loudest signal that can be recorded). In theory the +maximum dynamic range of signal is number_of_bits * 6 dB . This means that +8 bits sampling resolution gives dynamic range of 48 dB and 16 bit resolution +gives 96 dB. +<p> +Quality has price. The number of bytes required to store an audio sequence +depends on sampling rate, number of channels and sampling resolution. For +example just 8000 bytes of memory is required to store one second of sound +using 8 kHz/8 bits/mono but 48 kHz/16bit/stereo takes 192 kilobytes. A 64 kbps +ISDN channel is required to transfer a 8kHz/8bit/mono audio stream in real +time, and about 1.5 Mbps is required for DAT quality (48kHz/16bit/stereo). +On the other hand it is possible to store just 5.46 seconds of sound in +a megabyte of memory when using 48kHz/16bit/stereo sampling. With +8kHz/8bits/mono it is possible to store 131 seconds of sound using the same +amount of memory. It is possible to reduce memory and communication costs by +compressing the recorded signal but this is out of the scope of this document. + +<sect1>Low-Level Layer + +<p> +Audio devices are opened exclusively for a selected direction. This doesn't +allow open from more than one processes for the same audio device in the +same direction, but does allow one open call to each playback direction and +second open call to record direction independently. Audio devices return +EBUSY error to applications when other applications have already opened the +requested direction. +<p> +Low-Level layer supports these formats: +<tscreen><code> +#define SND_PCM_SFMT_MU_LAW 0 +#define SND_PCM_SFMT_A_LAW 1 +#define SND_PCM_SFMT_IMA_ADPCM 2 +#define SND_PCM_SFMT_U8 3 +#define SND_PCM_SFMT_S16_LE 4 +#define SND_PCM_SFMT_S16_BE 5 +#define SND_PCM_SFMT_S8 6 +#define SND_PCM_SFMT_U16_LE 7 +#define SND_PCM_SFMT_U16_BE 8 +#define SND_PCM_SFMT_MPEG 9 +#define SND_PCM_SFMT_GSM 10 + +#define SND_PCM_FMT_MU_LAW (1 << SND_PCM_SFMT_MU_LAW) +#define SND_PCM_FMT_A_LAW (1 << SND_PCM_SFMT_A_LAW) +#define SND_PCM_FMT_IMA_ADPCM (1 << SND_PCM_SFMT_IMA_ADPCM) +#define SND_PCM_FMT_U8 (1 << SND_PCM_SFMT_U8) +#define SND_PCM_FMT_S16_LE (1 << SND_PCM_SFMT_S16_LE) +#define SND_PCM_FMT_S16_BE (1 << SND_PCM_SFMT_S16_BE) +#define SND_PCM_FMT_S8 (1 << SND_PCM_SFMT_S8) +#define SND_PCM_FMT_U16_LE (1 << SND_PCM_SFMT_U16_LE) +#define SND_PCM_FMT_U16_BE (1 << SND_PCM_SFMT_U16_BE) +#define SND_PCM_FMT_MPEG (1 << SND_PCM_SFMT_MPEG) +#define SND_PCM_FMT_GSM (1 << SND_PCM_SFMT_GSM) +</code></tscreen> +Constants with prefix <bf>SND_PCM_FMT_</bf> are used in info structures +and constants with prefix <bf>SND_PCM_SFMT_</bf> are used in format structures. + +<sect2>int snd_pcm_open( void **handle, int card, int device, int mode ) + <p> + Creates a new handle and opens a connection to kernel sound + audio interface for soundcard number <it>card</it> (0-N) and audio + device number <it>device</it>. Function also checks if protocol is + compatible to prevent use of old programs with a new kernel API. Function + returns zero if successful,ful otherwise it returns an error code. + Error code -EBUSY is returned when some process ownes the selected direction. + <p> + Default format after opening is mono <it>mu-Law</it> at 8000Hz. This device + can be used directly for playback of standard .au (Sparc) files. + <p> + The following modes should be used for the <it>mode</it> argument: + <code> + #define SND_PCM_OPEN_PLAYBACK (O_WRONLY) + #define SND_PCM_OPEN_RECORD (O_RDONLY) + #define SND_PCM_OPEN_DUPLEX (O_RDWR) + </code> + +<sect2>int snd_pcm_close( void *handle ) + <p> + Frees all resources allocated with audio handle and + closes the connection to the kernel sound audio interface. Function + returns zero if successful, otherwise it returns an error code. + +<sect2>int snd_pcm_file_descriptor( void *handle ) + <p> + Returns the file descriptor of the connection to the kernel sound + audio interface. Function returns an error code if an + error was encountered. + <p> + The file descriptor should be used for the <it>select</it> synchronous + multiplexer function for setting the read direction. Application should + call <it>snd_pcm_read</it> or <it>snd_pcm_write</it> functions if some + data is waiting for reading or a write can be performed. Calling this + function is highly recomended, as it leaves a place for the API to things + like data conversions, if needed. + +<sect2>int snd_pcm_block_mode( void *handle, int enable ) + <p> + Sets up block (default) or nonblock mode for a handle. Block mode suspends + execution of a program when <it>snd_pcm_read</it> or <it>snd_pcm_write</it> + is called for the time which is needed for the actual playback or record + over of the entire buffer. In nonblock mode, programs aren't suspended and + the above functions returns immediately with the count of bytes which were + read or written by the driver. When used in this way, don't try to use the + entire buffer after the call, but instead process the number of bytes + returned, and call the function again. + +<sect2>int snd_pcm_info( void *handle, snd_pcm_info_t *info ) + <p> + Fills the *info structure with data about the PCM device selected by + *handle. Function returns zero if successful, otherwise it returns + an error code. + <code> + #define SND_PCM_INFO_CODEC 0x00000001 + #define SND_PCM_INFO_DSP SND_PCM_INFO_CODEC + #define SND_PCM_INFO_MMAP 0x00000002 /* reserved */ + #define SND_PCM_INFO_PLAYBACK 0x00000100 + #define SND_PCM_INFO_RECORD 0x00000200 + #define SND_PCM_INFO_DUPLEX 0x00000400 + #define SND_PCM_INFO_DUPLEX_LIMIT 0x00000800 /* rate for playback & record are same */ + + struct snd_pcm_info { + unsigned int type; /* soundcard type */ + unsigned int flags; /* see SND_PCM_INFO_XXXX */ + unsigned char id[32]; /* ID of this PCM device */ + unsigned char name[80]; /* name of this device */ + unsigned char reserved[64]; /* reserved for future use */ + }; + </code> + <descrip> + <tag>SND_PCM_INFO_MMAP</tag> + This flag is reserved and should be never used. It remains for + compatibility with Open Sound System driver. + <tag>SND_PCM_INFO_DUPLEX_LIMIT</tag> + If this bit is set, rate must be same for playback and record direction. + </descrip> + +<sect2>int snd_pcm_playback_info( void *handle, snd_pcm_playback_info_t *info ) + <p> + Fills the *info structure with data about PCM playback. Function returns + zero if successful, otherwise it returns an error code. + <code> + #define SND_PCM_PINFO_BATCH 0x00000001 + #define SND_PCM_PINFO_8BITONLY 0x00000002 + #define SND_PCM_PINFO_16BITONLY 0x00000004 + + struct snd_pcm_playback_info { + unsigned int flags; /* see SND_PCM_PINFO_XXXX */ + unsigned int formats; /* supported formats */ + unsigned int min_rate; /* min rate (in Hz) */ + unsigned int max_rate; /* max rate (in Hz) */ + unsigned int min_channels; /* min channels (probably always 1) */ + unsigned int max_channels; /* max channels */ + unsigned int buffer_size; /* playback buffer size */ + unsigned int min_fragment_size; /* min fragment size in bytes */ + unsigned int max_fragment_size; /* max fragment size in bytes */ + unsigned int fragment_align; /* align fragment value */ + unsigned char reserved[64]; /* reserved for future use */ + }; + </code> + <descrip> + <tag>SND_PCM_PINFO_BATCH</tag> + Driver implements double buffering with this device. This means that + the chip used for data processing has its own memory, and output should be + more delayed than if a traditional codec chip is used. + <tag>SND_PCM_PINFO_8BITONLY</tag> + If this bit is set, the driver uses 8-bit format for 16-bit samples and + does software conversion. This bit is set on broken SoundBlaster 16/AWE + soundcards which can't do full 16-bit duplex. If this bit is set + application or highter digital audio layer should do the conversion from + 16-bit samples to 8-bit samples rather than making the driver to do it in + the kernel. + <tag>SND_PCM_PINFO_16BITONLY</tag> + If this bit is set, driver uses 16-bit format for 8-bit samples and + does software conversion. This bit is set on broken SoundBlaster 16/AWE + soundcards which can't do full 8-bit duplex. If this bit is set the + application or highter digital audio layer should do conversion from + 8-bit samples to 16-bit samples rather than making the driver to do it in + the kernel. + </descrip> + +<sect2>int snd_pcm_record_info( void *handle, snd_pcm_record_info_t *info ) + <p> + Fills the *info structure. Returns zero if successful, otherwise it returns + an error code. + <code> + #define SND_PCM_RINFO_BATCH 0x00000001 + #define SND_PCM_RINFO_8BITONLY 0x00000002 + #define SND_PCM_RINFO_16BITONLY 0x00000004 + + struct snd_pcm_record_info { + unsigned int flags; /* see to SND_PCM_RINFO_XXXX */ + unsigned int formats; /* supported formats */ + unsigned int min_rate; /* min rate (in Hz) */ + unsigned int max_rate; /* max rate (in Hz) */ + unsigned int min_channels; /* min channels (probably always 1) */ + unsigned int max_channels; /* max channels */ + unsigned int buffer_size; /* record buffer size */ + unsigned int min_fragment_size; /* min fragment size in bytes */ + unsigned int max_fragment_size; /* max fragment size in bytes */ + unsigned int fragment_align; /* align fragment value */ + unsigned char reserved[64]; /* reserved for future... */ + }; + </code> + <descrip> + <tag>SND_PCM_PINFO_BATCH</tag> + Driver implements buffering for this device. This means that + the chip used for data processing has its own memory and output should be + more delayed than if a traditional codec chip is used. + <tag>SND_PCM_PINFO_8BITONLY</tag> + If this bit is set, the device uses 8-bit format for 16-bit samples and + does software conversion. This bit is set on broken SoundBlaster 16/AWE + soundcards which can't do full 16-bit duplex. If this bit is set the + application or highter digital audio layer should do conversion from + 16-bit samples to 8-bit samples rather than making the driver to do it in + the kernel. + <tag>SND_PCM_PINFO_16BITONLY</tag> + If this bit is set, the device uses a 16-bit format for 8-bit samples and + does software conversion. This bit is set on broken SoundBlaster 16/AWE + soundcards which can't do full 8-bit duplex. If this bit is set the + application or highter digital audio layer should do the conversion from + 8-bit samples to 16-bit samples rather than making the driver to do it in + the kernel. + </descrip> + +<sect2>int snd_pcm_playback_format( void *handle, snd_pcm_format_t *format ) + <p> + Sets up format, rate (in Hz) and number of channels for playback, in the + desired direction. Function returns zero if successful, otherwise it + returns an error code. + <code> + struct snd_pcm_format { + unsigned int format; /* SND_PCM_SFMT_XXXX */ + unsigned int rate; /* rate in Hz */ + unsigned int channels; /* channels (voices) */ + unsigned char reserved[16]; + }; + </code> + +<sect2>int snd_pcm_record_format( void *handle, snd_pcm_format_t *format ) + <p> + Sets up format, rate (in Hz) and number of channels for used for recording + in the specified direction. Function returns zero if successful, otherwise + it returns an error code. + <code> + struct snd_pcm_format { + unsigned int format; /* SND_PCM_SFMT_XXXX */ + unsigned int rate; /* rate in Hz */ + unsigned int channels; /* channels (voices) */ + unsigned char reserved[16]; + }; + </code> + +<sect2>int snd_pcm_playback_params( void *handle, snd_pcm_playback_params_t *params ) + <p> + Sets various parameters for playback direction. Function returns zero if + successful, otherwise it returns an error code. + <code> + struct snd_pcm_playback_params { + int fragment_size; + int fragments_max; + int fragments_room; + unsigned char reserved[16]; /* must be filled with zero */ + }; + </code> + <descrip> + <tag>fragment_size</tag> + Requested size of fragment. This value should be aligned for current + format (for example to 4 if stereo 16-bit samples are used) or with the + <it>fragment_align</it> variable from <it>snd_pcm_playback_info_t</it> + structure. Its range can be from <it>min_fragment_size</it> to + <it>max_fragment_size</it>. + <tag>fragments_max</tag> + Maximum number of fragments in queue for wakeup. This number doesn't + counts partly used fragment. If current count of filled playback fragments + is greater than this value driver block application or return immediately + back if nonblock mode is active. + <tag>fragments_room</tag> + Minumum number of fragments writeable for wakeup. This value should be + in most cases 1 which means return back to application if at least + one fragment is free for playback. This value includes partly used fragments, + too. + </descrip> + +<sect2>int snd_pcm_record_params( void *handle, snd_pcm_record_params_t *params ) + <p> + Function sets various parameters for the recording direction. Function returns + zero if successful, otherwise it returns an error code. + <code> + struct snd_pcm_record_params { + int fragment_size; + int fragments_min; + unsigned char reserved[16]; + }; + </code> + <descrip> + <tag>fragment_size</tag> + Requested size of fragment. This value should be aligned for current + format (for example to 4 if stereo 16-bit samples are used) or set to the + <it>fragment_align</it> variable from <it>snd_pcm_playback_info_t</it> + structure. Its range can be from <it>min_fragment_size</it> to + <it>max_fragment_size</it>. + <tag>fragments_min</tag> + Minimum filled fragments for wakeup. Driver blocks the application (if + block mode is selected) until it isn't filled with number of fragments + specified with this value. + </descrip> + +<sect2>int snd_pcm_playback_status( void *handle, snd_pcm_playback_status_t *status ) + <p> + Fills the *status structure. Function returns zero if successful, otherwise + it returns an error code. + <code> + struct snd_pcm_playback_status { + unsigned int rate; + int fragments; + int fragment_size; + int count; + int queue; + int underrun; + struct timeval time; + struct timeval stime; + unsigned char reserved[16]; + }; + </code> + <descrip> + <tag>rate</tag> + Real playback rate. This value reflects hardware limitations. + <tag>fragments</tag> + Currently allocated fragments by the driver for playback direction. + <tag>fragment_size</tag> + Current fragment size used by driver for the playback direction. + <tag>count</tag> + Count of bytes writeable without blocking. + <tag>queue</tag> + Count of bytes in queue. Note: <it>(fragments * fragment_size) - queue</it> + should not be equal to <it>count</it>. + <tag>underrun</tag> + This value tells the application the number of underruns since the ast call + of <it>snd_pcm_playback_status</it>. + <tag>time</tag> + Delay till played of the first sample from next write. This value should + be used for time synchronization. Returned value is in the same format as + returned from the standard C function <it>gettimeofday( &ero;time, NULL )</it>. + This variable contains right value only if playback time mode is enabled + (look to <it>snd_pcm_playback_time</it> function). + <tag>stime</tag> + Time when playback was started. + This variable contains right value only if playback time mode is enabled + (look to <it>snd_pcm_playback_time</it> function). + </descrip> + +<sect2>int snd_pcm_record_status( void *handle, snd_pcm_record_status_t *status ) + <p> + Fills the *status structure. Function returns zero if successful, otherwise + it returns an error code. + <code> + struct snd_pcm_record_status { + unsigned int rate; + int fragments; + int fragment_size; + int count; + int free; + int overrun; + struct timeval time; + unsigned char reserved[16]; + }; + </code> + <descrip> + <tag>rate</tag> + Real record rate. This value reflects hardware limitations. + <tag>fragments</tag> + Currently allocated fragments by driver for the record direction. + <tag>fragment_size</tag> + Current fragment size used by driver for the record direction. + <tag>count</tag> + Count of bytes readable without blocking. + <tag>free</tag> + Count of bytes in buffer still free. Note: <it>(fragments * fragment_size) - free</it> + should not be equal to <it>count</it>. + <tag>overrun</tag> + This value tells application the count of overruns since the last call + to <it>snd_pcm_record_status</it>. + <tag>time</tag> + Lag since the next sample read was recorded. This value should be used for time + synchronization. Returned value is in the same format as returned by the + from standard C function <it>gettimeofday( &ero;time, NULL )</it>. This + variable contains right value only if record time mode is enabled (look to + <it>snd_pcm_record_time</it> function). + <tag>stime</tag> + Time when record was started. This variable contains right value only if + record time mode is enabled (look to <it>snd_pcm_record_time</it> function). + </descrip> + +<sect2>int snd_pcm_drain_playback( void *handle ) + <p> + This function drain playback buffers immediately. Function returns zero + if successful, otherwise it returns an error code. + +<sect2>int snd_pcm_flush_playback( void *handle ) + <p> + This function flushes the playback buffers. It blocks the program while the + all the waiting samples in kernel playback buffers are processed. Function + returns zero if successful, otherwise it returns an error code. + +<sect2>int snd_pcm_flush_record( void *handle ) + <p> + This function flushes (destroyes) record buffers. Function returns zero + if successful, otherwise it returns an error code. + +<sect2>int snd_pcm_playback_time( void *handle, int enable ) + <p> + This function enables or disables time mode for playback direction. Time mode + allows to application better time synchronization. Function returns zero + if successful, otherwise it returns an error code. + +<sect2>int snd_pcm_record_time( void *handle, int enable ) + <p> + This function enables or disables time mode for record direction. Time mode + allows to application better time synchronization. Function returns zero + if successful, otherwise it returns an error code. + +<sect2>ssize_t snd_pcm_write( void *handle, const void *buffer, size_t size ) + <p> + Writes samples to the device which must be in the proper format + specified by the <it>snd_pcm_playback_format</it> function. Function + returns zero or positive value if playback was successful (value represents + count of bytes which was successfuly written to device) or an + error value if error occured. Function should suspend process if + block mode is active. + +<sect2>ssize_t snd_pcm_read( void *handle, void *buffer, size_t size ) + <p> + Function reads samples from driver. Samples are in format specified + by <it>snd_pcm_record_format</it> function. Function returns zero + or positive value if record was success (value represents count of bytes + which was successfuly read from device) or negative error value if + error occured. Function should suspend process if block mode is active. + +<sect1>Examples + +<p> +The following example shows how to play the first 512kB from the +/tmp/test.au file with soundcard #0 and PCM device #0: + +<tscreen><code> +int card = 0, device = 0, err, fd, count, size, idx; +void *handle; +snd_pcm_format_t format; +char *buffer; + +buffer = (char *)malloc( 512 * 1024 ); +if ( !buffer ) return; +if ( (err = snd_pcm_open( &ero;handle, card, device, SND_PCM_OPEN_PLAYBACK )) < 0 ) { + fprintf( stderr, "open failed: %s\n", snd_strerror( err ) ); + return; +} +format.format = SND_PCM_SFMT_MU_LAW; +format.rate = 8000; +format.voices = 1; +if ( (err = snd_pcm_playback_format( handle, &ero;format )) < 0 ) { + fprintf( stderr, "format setup failed: %s\n", snd_strerror( err ) ); + snd_pcm_close( handle ); + return; +} +fd = open( "/tmp/test.au" ); +if ( fd < 0 ) { + perror( "open file" ); + snd_pcm_close( handle ); + return; +} +idx = 0; +count = read( fd, buffer, 512 * 1024 ); +if ( count <= 0 ) { + perror( "read from file" ); + snd_pcm_close( handle ); + return; +} +close( fd ); +if ( !memcmp( buffer, ".snd", 4 ) ) { + idx = (buffer[4]<<24)|(buffer[5]<<16)|(buffer[6]<<8)|(buffer[7]); + if ( idx > 128 ) idx = 128; + if ( idx > count ) idx = count; +} +size = snd_pcm_write( handle, &ero;buffer[ idx ], count - idx ); +printf( "Bytes written %i from %i...\n", size, count - idx ); +snd_pcm_close( handle ); +free( buffer ); +</code></tscreen> + +</article> diff --git a/doc/soundapi.txt b/doc/soundapi.txt new file mode 100644 index 00000000..ebe5d45f --- /dev/null +++ b/doc/soundapi.txt @@ -0,0 +1,1230 @@ + Advanced Linux Sound Architecture - Library API + Jaroslav Kysela <perex@jcu.cz> with assistance from Alan + Robinson + v0.0.3, 25 March 1998 + + This document describes, in full detail, the Advanced Linux Sound + Architecture library API. + ______________________________________________________________________ + + Table of Contents: + + 1. Introduction + + 2. Error Codes + + 2.1. Error Codes in Detail + + 2.2. Functions + + 2.2.1. const char *snd_strerror( int errnum ) + + 3. Control Interface + + 3.1. Low-Level Layer + + 3.1.1. int snd_cards( void ) + + 3.1.2. unsigned int snd_cards_mask( void ) + + 3.1.3. int snd_ctl_open( void **handle, int card ) + + 3.1.4. int snd_ctl_close( void *handle ) + + 3.1.5. int snd_ctl_file_descriptor( void *handle ) + + 3.1.6. int snd_ctl_hw_info( void *handle, struct snd_ctl_hw_info + *info ) + + 3.1.7. int snd_ctl_pcm_info( void *handle, int dev, snd_pcm_info_t + *info ) + + 3.1.8. int snd_ctl_pcm_playback_info( void *handle, int dev, + snd_pcm_playback_info_t *info ) + + 3.1.9. int snd_ctl_pcm_record_info( void *handle, int dev, + snd_pcm_record_info_t *info ) + + 3.1.10. int snd_ctl_mixer_info( void *handle, int dev, + snd_mixer_info_t *info ) + + 3.2. Examples + + 4. Mixer Interface + + 4.1. Low-Level Layer + + 4.1.1. int snd_mixer_open( void **handle, int card, int device ) + + 4.1.2. int snd_mixer_close( void *handle ) + + 4.1.3. int snd_mixer_file_descriptor( void *handle ) + + 4.1.4. int snd_mixer_channels( void *handle ) + + 4.1.5. int snd_mixer_info( void *handle, snd_mixer_info_t *info ) + + 4.1.6. int snd_mixer_channel( void *handle, const char *channel_id ) + + 4.1.7. int snd_mixer_exact_mode( void *handle, int enable ) + + 4.1.8. int snd_mixer_channel_info( void *handle, int channel, + snd_mixer_channel_info_t *info ) + + 4.1.9. int snd_mixer_channel_read( void *handle, int channel, + snd_mixer_channel_t *data ) + + 4.1.10. int snd_mixer_channel_write( void *handle, int channel, + snd_mixer_channel_t *data ) + + 4.1.11. int snd_mixer_special_read( void *handle, snd_mixer_special_t + *special ) + + 4.1.12. int snd_mixer_special_write( void *handle, snd_mixer_special_t + *special ) + + 4.1.13. int snd_mixer_read( void *handle, snd_mixer_callbacks_t + *callbacks ) + + 4.2. Examples + + 5. Digital Audio (PCM) Interface + + 5.1. Low-Level Layer + + 5.1.1. int snd_pcm_open( void **handle, int card, int device, int + mode ) + + 5.1.2. int snd_pcm_close( void *handle ) + + 5.1.3. int snd_pcm_file_descriptor( void *handle ) + + 5.1.4. int snd_pcm_block_mode( void *handle, int enable ) + + 5.1.5. int snd_pcm_info( void *handle, snd_pcm_info_t *info ) + + 5.1.6. int snd_pcm_playback_info( void *handle, + snd_pcm_playback_info_t *info ) + + 5.1.7. int snd_pcm_record_info( void *handle, snd_pcm_record_info_t + *info ) + + 5.1.8. int snd_pcm_playback_format( void *handle, snd_pcm_format_t + *format ) + + 5.1.9. int snd_pcm_record_format( void *handle, snd_pcm_format_t + *format ) + + 5.1.10. int snd_pcm_playback_params( void *handle, + snd_pcm_playback_params_t *params ) + + 5.1.11. int snd_pcm_record_params( void *handle, + snd_pcm_record_params_t *params ) + + 5.1.12. int snd_pcm_playback_status( void *handle, + snd_pcm_playback_status_t *status ) + + 5.1.13. int snd_pcm_record_status( void *handle, + snd_pcm_record_status_t *status ) + + 5.1.14. int snd_pcm_drain_playback( void *handle ) + + 5.1.15. int snd_pcm_flush_playback( void *handle ) + + 5.1.16. int snd_pcm_flush_record( void *handle ) + + 5.1.17. int snd_pcm_playback_time( void *handle, int enable ) + + 5.1.18. int snd_pcm_record_time( void *handle, int enable ) + + 5.1.19. ssize_t snd_pcm_write( void *handle, const void *buffer, + size_t size ) + + 5.1.20. ssize_t snd_pcm_read( void *handle, void *buffer, size_t size + ) + + 5.2. Examples + ______________________________________________________________________ + + 11.. IInnttrroodduuccttiioonn + + The Advanced Linux Sound Architecture comes with a kernel API & + library API. This document describes the library API and how it + interfaces with the kernel API. The kernal API will probably never be + documented in standalone form. + + Application programmers should use the library API rather than kernel + API. The Library offers 100% of the functionally of the kernel API, + but add next major improvements in usability, making the application + code simpler and better looking. In addition, some of the some + fixes/compatibility code in, may be placed in the library code instead + of the kernel driver. + + For a complete list of all variables and functions in the API you + should look at the following header files: + + 1. /usr/include/sys/soundlib.h + + 2. /usr/include/linux/sound.h + + 3. /usr/include/linux/sounddetect.h + + 22.. EErrrroorr CCooddeess + + All functions return int (or some sort of signed value). If this value + is negative it represents an error code. Codes up to SND_ERROR_BEGIN + (500000) represents standard system errors. Codes equal or greather + than this value represents sound library API errors. All error codes + begin with the prefix _S_N_D___E_R_R_O_R__. + + 22..11.. EErrrroorr CCooddeess iinn DDeettaaiill + + SSNNDD__EERRRROORR__UUNNCCOOMMPPAATTIIBBLLEE__VVEERRSSIIOONN ((550000000000)) + This error is caused if the driver uses an incompatible kernel + API for this interface and hence the library doesn't know how + this API can be used. + + 22..22.. FFuunnccttiioonnss + + 22..22..11.. + + ccoonnsstt cchhaarr **ssnndd__ssttrreerrrroorr(( iinntt eerrrrnnuumm )) + + This functions converts error code to a string. Its functionality is + the same as the _s_t_r_e_r_r_o_r function from the standard C library, but + this function returns correct strings for sound error codes, too. + + 33.. CCoonnttrrooll IInntteerrffaaccee + + The control interfaces gives application various information about the + currently installed sound driver in the system. The interface should + be used to detect if another sound interface is present for selected + soundcard or, for example, to create a list of devices (MIXER, PCM + etc) from which the user can select. + + 33..11.. LLooww--LLeevveell LLaayyeerr + + 33..11..11.. + + iinntt ssnndd__ccaarrddss(( vvooiidd )) + + Returns the number of soundcards present in the system, if any. + Otherwise it returns a negative value, which maps to an error code. + This function will return 0 if no soundcards are detected. + + 33..11..22.. + + uunnssiiggnneedd iinntt ssnndd__ccaarrddss__mmaasskk(( vvooiidd )) + + Returns the bitmap of soundcards present in the system, if any. + Otherwise it returns a negative value, which maps to an error code. + This function will return 0 if no soundcards are detected. First + soundcard is represented with bit 0. + + 33..11..33.. + + iinntt ssnndd__ccttll__ooppeenn(( vvooiidd ****hhaannddllee,, iinntt ccaarrdd )) + + Creates a new handle and opens communication with the kernel sound + control interface for soundcard number _c_a_r_d (0-N). The function also + checks if protocol is compatible, so as to prevent the use of old + programs with a new kernel API. Function returns zero if successful, + otherwise an error code is returned. + + 33..11..44.. + + iinntt ssnndd__ccttll__cclloossee(( vvooiidd **hhaannddllee )) + + Function frees all resources allocated with control handle and closes + the kernel sound control interface. Function returns zero if + successful, otherwise it returns an error code. + + 33..11..55.. + + iinntt ssnndd__ccttll__ffiillee__ddeessccrriippttoorr(( vvooiidd **hhaannddllee )) + + Function returns file descriptor for the kernel sound control + interface. This function should be used in very special cases. + Function returns a negative error code if some error was encountered. + 33..11..66.. + + iinntt ssnndd__ccttll__hhww__iinnffoo(( vvooiidd **hhaannddllee,, ssttrruucctt ssnndd__ccttll__hhww__iinnffoo **iinnffoo )) + + Fills the info structure with data about the sound hardware referenced + by handle. Function returns zero if successful, otherwise it returns + an error code. + + ______________________________________________________________________ + #define SND_CTL_GCAPS_MIDI 0x0000001 /* driver has MIDI interface */ + + #define SND_CTL_LCAPS_SYNTH 0x0000001 /* soundcard has synthesizer */ + #define SND_CTL_LCAPS_RAWFM 0x0000002 /* soundcard has RAW FM/OPL3 */ + + struct snd_ctl_hw_info { + unsigned int type; /* type of card - see SND_CARD_TYPE_XXXX */ + unsigned int gcaps; /* see SND_CTL_GCAPS_XXXX */ + unsigned int lcaps; /* see SND_CTL_LCAPS_XXXX */ + unsigned int pcmdevs; /* count of PCM devices (0 to N) */ + unsigned int mixerdevs; /* count of MIXER devices (0 to N) */ + unsigned int mididevs; /* count of raw MIDI devices (0 to N) */ + char id[8]; /* ID of card (user selectable) */ + char name[80]; /* name/info text about soundcard */ + unsigned char reserved[128]; /* reserved for future use */ + }; + + ______________________________________________________________________ + + 33..11..77.. + + iinntt ssnndd__ccttll__ppccmm__iinnffoo(( vvooiidd **hhaannddllee,, iinntt ddeevv,, ssnndd__ppccmm__iinnffoo__tt **iinnffoo )) + + Fills the *info structure with data about the PCM device. Function + returns zero if successful, otherwise it returns an error code. + Details about the snd_pcm_info_t structure are in the DDiiggiittaall AAuuddiioo + ((PPCCMM)) IInntteerrffaaccee section. The argument _d_e_v selects the device number + for the soundcard referenced by *handle. Its range is 0 to N where N + is _s_t_r_u_c_t _s_n_d___c_t_l___h_w___i_n_f_o _-_> _p_c_m_d_e_v_s _- _1. This function will work if + the selected PCM device is busy, too. It should be used to collect + information about PCM devices without exclusive lock. + + 33..11..88.. + + iinntt ssnndd__ccttll__ppccmm__ppllaayybbaacckk__iinnffoo(( vvooiidd **hhaannddllee,, iinntt ddeevv,, ssnndd__ppccmm__ppllaayy-- + bbaacckk__iinnffoo__tt **iinnffoo )) + + Fills the *info structure with data about the PCM device and playback + direction. Function returns zero if successful, otherwise it returns + an error code. Details about the snd_pcm_playback_info_t structure + are in the DDiiggiittaall AAuuddiioo ((PPCCMM)) IInntteerrffaaccee section. The argument _d_e_v + selects the device number for the soundcard referenced by *handle. Its + range is 0 to N where N is _s_t_r_u_c_t _s_n_d___c_t_l___h_w___i_n_f_o _-_> _p_c_m_d_e_v_s _- _1. + This function will work if the selected PCM device is busy, too. It + should be used to collect information about PCM devices without + exclusive lock. + + 33..11..99.. + + iinntt ssnndd__ccttll__ppccmm__rreeccoorrdd__iinnffoo(( vvooiidd **hhaannddllee,, iinntt ddeevv,, + ssnndd__ppccmm__rreeccoorrdd__iinnffoo__tt **iinnffoo )) + + Fills the *info structure with data about the PCM device and record + direction. Function returns zero if successful, otherwise it returns + an error code. Details about the snd_pcm_record_info_t structure are + in the DDiiggiittaall AAuuddiioo ((PPCCMM)) IInntteerrffaaccee section. The argument _d_e_v selects + the device number for the soundcard referenced by *handle. Its range + is 0 to N where N is _s_t_r_u_c_t _s_n_d___c_t_l___h_w___i_n_f_o _-_> _p_c_m_d_e_v_s _- _1. This + function will work if the selected PCM device is busy, too. It should + be used to collect information about PCM devices without exclusive + lock. + + 33..11..1100.. + + iinntt ssnndd__ccttll__mmiixxeerr__iinnffoo(( vvooiidd **hhaannddllee,, iinntt ddeevv,, ssnndd__mmiixxeerr__iinnffoo__tt **iinnffoo + )) + + Fills the *info structure with data about the mixer device. Returns + zero if successful, otherwise it returns an error code. Details about + the snd_mixer_info_t structure are in the MMiixxeerr IInntteerrffaaccee section. + The argument _d_e_v specifies the device number for the appropriate + soundcard. Its range is 0 to N where N found from _s_t_r_u_c_t + _s_n_d___c_t_l___h_w___i_n_f_o _-_> _m_i_x_e_r_d_e_v_s _- _1. It should be used to collect + information about mixer devices. + + 33..22.. EExxaammpplleess + + The following example shows how all PCM devices can be detected for + the first soundcard (#0) in the system. + + ______________________________________________________________________ + int card = 0, err; + void *handle; + stuct snd_ctl_hw_info info; + + if ( (err = snd_ctl_open( &handle, card )) < 0 ) { + fprintf( stderr, "open failed: %s\n", snd_strerror( err ) ); + return; + } + if ( (err = snd_ctl_hw_info( handle, &info )) < 0 ) { + fprintf( stderr, "hw info failed: %s\n", snd_strerror( err ) ); + snd_ctl_close( handle ); + return; + } + printf( "Installed PCM devices for card #i: %i\n", card + 1, info.pcmdevs ); + snd_ctl_close( handle ); + ______________________________________________________________________ + + 44.. MMiixxeerr IInntteerrffaaccee + + The Mixer Interface allows applications to change the volume level of + a soundcard's input/output channels in both the linear range (0-100) + and in decibels. It also supports features like hardware mute, input + sound source, etc. + + 44..11.. LLooww--LLeevveell LLaayyeerr + + Mixer devices aren't opened exclusively. This allows applications to + open a device multiple times with one or more processes. + 44..11..11.. + + iinntt ssnndd__mmiixxeerr__ooppeenn(( vvooiidd ****hhaannddllee,, iinntt ccaarrdd,, iinntt ddeevviiccee )) + + Creates new handle and opens a connection to the kernel sound mixer + interface for soundcard number _c_a_r_d (0-N) and mixer device number + _d_e_v_i_c_e. Also checks if protocol is compatible to prevent use of old + programs with new kernel API. Function returns zero if successful, + otherwise it returns an error code. + + 44..11..22.. + + iinntt ssnndd__mmiixxeerr__cclloossee(( vvooiidd **hhaannddllee )) + + Frees all resources allocated to the mixer handle and closes its + connection to the kernel sound mixer interface. Function returns zero + if successful, otherwise it returns an error code. + + 44..11..33.. + + iinntt ssnndd__mmiixxeerr__ffiillee__ddeessccrriippttoorr(( vvooiidd **hhaannddllee )) + + Returns the file descriptor for the connection to the kernel sound + mixer interface. This function should be used only in very special + cases. Function returns a negative error code if an error was + encountered. + + The file descriptor should be used for the _s_e_l_e_c_t synchronous + multiplexer function for deterimeing read direction. Applications + should call _s_n_d___m_i_x_e_r___r_e_a_d function if some data is waiting to be + read. It is recomended that you do this, since it leaves place for + this function to handle some new kernel API specifications. + + 44..11..44.. + + iinntt ssnndd__mmiixxeerr__cchhaannnneellss(( vvooiidd **hhaannddllee )) + + Returns the count of mixer channels for appropriate mixer device, + otherwise the return value is negative, and signifies an error code. + Never returns zero. + + 44..11..55.. + + iinntt ssnndd__mmiixxeerr__iinnffoo(( vvooiidd **hhaannddllee,, ssnndd__mmiixxeerr__iinnffoo__tt **iinnffoo )) + + Fills the *info structure with information about the mixer associated + with *handle. Returns zero if successful, otherwise it returns an + error code. + + ______________________________________________________________________ + #define SND_MIXER_INFO_CAP_EXCL_RECORD 0x00000001 + + struct snd_mixer_info { + unsigned int type; /* type of soundcard - SND_CARD_TYPE_XXXX */ + unsigned int channels; /* count of mixer devices */ + unsigned int caps; /* some flags about this device (SND_MIXER_INFO_CAP_XXXX) */ + unsigned char id[32]; /* ID of this mixer */ + unsigned char name[80]; /* name of this device */ + char reserved[ 32 ]; /* reserved for future use */ + }; + + ______________________________________________________________________ + + 44..11..66.. + + iinntt ssnndd__mmiixxeerr__cchhaannnneell(( vvooiidd **hhaannddllee,, ccoonnsstt cchhaarr **cchhaannnneell__iidd )) + + Returns the channel number (index) associated with channel_id (channel + name), or returns an error code. + + ______________________________________________________________________ + #define SND_MIXER_ID_MASTER "Master" + #define SND_MIXER_ID_BASS "Bass" + #define SND_MIXER_ID_TREBLE "Treble" + #define SND_MIXER_ID_SYNTHESIZER "Synth" + #define SND_MIXER_ID_SYNTHESIZER1 "Synth 1" + #define SND_MIXER_ID_FM "FM" + #define SND_MIXER_ID_EFFECT "Effect" + #define SND_MIXER_ID_PCM "PCM" + #define SND_MIXER_ID_PCM1 "PCM 1" + #define SND_MIXER_ID_LINE "Line-In" + #define SND_MIXER_ID_MIC "MIC" + #define SND_MIXER_ID_CD "CD" + #define SND_MIXER_ID_GAIN "Record-Gain" + #define SND_MIXER_ID_IGAIN "In-Gain" + #define SND_MIXER_ID_OGAIN "Out-Gain" + #define SND_MIXER_ID_LOOPBACK "Loopback" + #define SND_MIXER_ID_SPEAKER "PC Speaker" + #define SND_MIXER_ID_AUXA "Aux A" + #define SND_MIXER_ID_AUXB "Aux B" + #define SND_MIXER_ID_AUXC "Aux C" + + ______________________________________________________________________ + + 44..11..77.. + + iinntt ssnndd__mmiixxeerr__eexxaacctt__mmooddee(( vvooiidd **hhaannddllee,, iinntt eennaabbllee )) + + Turns on or off (by default) exact mode. This mode allows to + application set/get volume values in exact range which uses hardware. + In non-exact mode is range always from 0 to 100 and conversion to + hardware range does driver. Function returns zero if successful, + otherwise it returns an error code. + + 44..11..88.. + + iinntt ssnndd__mmiixxeerr__cchhaannnneell__iinnffoo(( vvooiidd **hhaannddllee,, iinntt cchhaannnneell,, ssnndd__mmiixxeerr__cchhaann-- + nneell__iinnffoo__tt **iinnffoo )) + Fills the *info structure. The argument _c_h_a_n_n_e_l specifies channel (0 + to N) for which is the info requested. Function returns zero if + successful, otherwise it returns an error code. + + ______________________________________________________________________ + #define SND_MIXER_CINFO_CAP_RECORD 0x00000001 + #define SND_MIXER_CINFO_CAP_STEREO 0x00000002 + #define SND_MIXER_CINFO_CAP_MUTE 0x00000004 + #define SND_MIXER_CINFO_CAP_HWMUTE 0x00000008 /* channel supports hardware mute */ + #define SND_MIXER_CINFO_CAP_DIGITAL 0x00000010 /* channel does digital (not analog) mixing */ + #define SND_MIXER_CINOF_CAP_INPUT 0x00000020 /* input channel */ + + struct snd_mixer_channel_info { + unsigned int channel; /* channel # (filled by application) */ + unsigned int parent; /* parent channel # or SND_MIXER_PARENT */ + unsigned char name[12]; /* name of this device */ + unsigned int caps; /* some flags about this device (SND_MIXER_CINFO_XXXX) */ + int min; /* min. value when exact mode (or always 0) */ + int max; /* max. value when exact mode (or always 100) */ + int min_dB; /* minimum decibel value (*100) */ + int max_dB; /* maximum decibel value (*100) */ + int step_dB; /* step decibel value (*100) */ + unsigned char reserved[16]; + }; + + ______________________________________________________________________ + + 44..11..99.. + + iinntt ssnndd__mmiixxeerr__cchhaannnneell__rreeaadd(( vvooiidd **hhaannddllee,, iinntt cchhaannnneell,, ssnndd__mmiixxeerr__cchhaann-- + nneell__tt **ddaattaa )) + + Fills the *data structure. The argument _c_h_a_n_n_e_l specifies the channel + (0 to N) for which is data requested. Function returns zero if + successful, otherwise it returns an error code. + + ______________________________________________________________________ + #define SND_MIXER_FLG_RECORD 0x00000001 /* channel record source flag */ + #define SND_MIXER_FLG_MUTE_LEFT 0x00010000 + #define SND_MIXER_FLG_MUTE_RIGHT 0x00020000 + #define SND_MIXER_FLG_MUTE 0x00030000 + #define SND_MIXER_FLG_DECIBEL 0x40000000 + #define SND_MIXER_FLG_FORCE 0x80000000 + + struct snd_mixer_channel { + unsigned int channel; /* channel # (filled by application) */ + unsigned int flags; /* some flags to read/write (SND_MIXER_FLG_XXXX) */ + int left; /* min - max when exact mode (or 0 - 100) */ + int right; /* min - max when exact mode (or 0 - 100) */ + int left_dB; /* dB * 100 */ + int right_dB; /* dB * 100 */ + unsigned char reserved[16]; + }; + + ______________________________________________________________________ + + SSNNDD__MMIIXXEERR__FFLLGG__RREECCOORRDD + Record source flag. + + SSNNDD__MMIIXXEERR__FFLLGG__DDEECCIIBBEELL + If this bit is set, driver set volume from dB variables _l_e_f_t___d_B + and _r_i_g_h_t___d_B. + + SSNNDD__MMIIXXEERR__FFLLGG__FFOORRCCEE + Force set - this bit shouldn't be used from user space. Reserved + for kernel. + + 44..11..1100.. + + iinntt ssnndd__mmiixxeerr__cchhaannnneell__wwrriittee(( vvooiidd **hhaannddllee,, iinntt cchhaannnneell,, + ssnndd__mmiixxeerr__cchhaannnneell__tt **ddaattaa )) + + Writes the *data structure to kernel. The _c_h_a_n_n_e_l argument specifies + the channel (0 to N) for which is data is to be applied. Function + returns zero if successful, otherwise it returns an error code. This + functions is the opposite of _s_n_d___m_i_x_e_r___c_h_a_n_n_e_l___r_e_a_d. + + 44..11..1111.. + + iinntt ssnndd__mmiixxeerr__ssppeecciiaall__rreeaadd(( vvooiidd **hhaannddllee,, ssnndd__mmiixxeerr__ssppeecciiaall__tt **ssppeecciiaall + )) + + Not documented... + + 44..11..1122.. + + iinntt ssnndd__mmiixxeerr__ssppeecciiaall__wwrriittee(( vvooiidd **hhaannddllee,, ssnndd__mmiixxeerr__ssppeecciiaall__tt **ssppee-- + cciiaall )) + + Not documented... + + 44..11..1133.. + + iinntt ssnndd__mmiixxeerr__rreeaadd(( vvooiidd **hhaannddllee,, ssnndd__mmiixxeerr__ccaallllbbaacckkss__tt **ccaallllbbaacckkss )) + + This function reads and parses data from driver. Parsed actions are + returned back to the application using the _c_a_l_l_b_a_c_k_s structure. + Applications should not parse data from the driver in standard cases. + This function returns immediately after all data is read from driver. + Does not block process. + + ______________________________________________________________________ + typedef struct snd_mixer_callbacks { + void *private_data; /* should be used by application */ + void (*channel_was_changed)( void *private_data, int channel ); + void *reserved[15]; /* reserved for future use - must be NULL!!! */ + } snd_mixer_callbacks_t; + + ______________________________________________________________________ + + 44..22.. EExxaammpplleess + + The following example shows installed mixer channels for soundcard #0 + and mixer device #0 in the system, and also sets the master volume (if + present) to 50. + + ______________________________________________________________________ + int card = 0, device = 0, err; + void *handle; + snd_mixer_info_t info; + snd_mixer_channel_t channel; + + if ( (err = snd_mixer_open( &handle, card, device )) < 0 ) { + fprintf( stderr, "open failed: %s\n", snd_strerror( err ) ); + return; + } + if ( (err = snd_mixer_info( handle, &info )) < 0 ) { + fprintf( stderr, "info failed: %s\n", snd_strerror( err ) ); + snd_mixer_close( handle ); + return; + } + printf( "Installed MIXER channels for card #i and device %i: %i\n", + card + 1, device, info.channels ); + master = snd_mixer_channel( handle, SND_MIXER_ID_MASTER ); + if ( master >= 0 ) { + if ( (err = snd_mixer_read( handle, master, &channel )) < 0 ) { + fprintf( stderr, "master read failed: %s\n", snd_strerror( err ) ); + snd_mixer_close( handle ); + return; + } + channel -> left = channel -> right = 50; + if ( (err = snd_mixer_write( handle, master, &channel )) < 0 ) { + fprintf( stderr, "master write failed: %s\n", snd_strerror( err ) ); + snd_mixer_close( handle ); + return; + } + } + snd_mixer_close( handle ); + ______________________________________________________________________ + + 55.. DDiiggiittaall AAuuddiioo ((PPCCMM)) IInntteerrffaaccee + + Digital audio is the most commonly used method of representing sound + inside a computer. In this method sound is stored as a sequence of + samples taken from the audio signal using constant time intervals. A + sample represents volume of the signal at the moment when it was + measured. In uncompressed digital audio each sample require one or + more bytes of storage. The number of bytes required depends on number + of channels (mono, stereo) and sample format (8 or 16 bits, mu-Law, + etc.). The length of this interval determines the sampling rate. + Commonly used sampling rates are between 8 kHz (telephone quality) and + 48 kHz (DAT tapes). + + The physical devices used in digital audio are called the ADC (Analog + to Digital Converter) and DAC (Digital to Analog Converter). A device + containing both ADC and DAC is commonly known as a codec. The codec + device used in a Sound Blaster cards is called a DSP which is somewhat + misleading since DSP also stands for Digital Signal Processor (the SB + DSP chip is very limited when compared to "true" DSP chips). + + Sampling parameters affect the quality of sound which can be + reproduced from the recorded signal. The most fundamental parameter is + sampling rate which limits the highest frequency than can be stored. + It is well known (Nyquist's Sampling Theorem) that the highest + frequency that can be stored in a sampled signal is at most 1/2 of the + sampling frequency. For example, a 8 kHz sampling rate permits the + recording of a signal in which the highest frequency is less than 4 + kHz. Higher frequency signals must be filtered out before feeding them + to DAC. + + Sample encoding limits the dynamic range of recorded signal + (difference between the faintest and the loudest signal that can be + recorded). In theory the maximum dynamic range of signal is + number_of_bits * 6 dB . This means that 8 bits sampling resolution + gives dynamic range of 48 dB and 16 bit resolution gives 96 dB. + + Quality has price. The number of bytes required to store an audio + sequence depends on sampling rate, number of channels and sampling + resolution. For example just 8000 bytes of memory is required to store + one second of sound using 8 kHz/8 bits/mono but 48 kHz/16bit/stereo + takes 192 kilobytes. A 64 kbps ISDN channel is required to transfer a + 8kHz/8bit/mono audio stream in real time, and about 1.5 Mbps is + required for DAT quality (48kHz/16bit/stereo). On the other hand it + is possible to store just 5.46 seconds of sound in a megabyte of + memory when using 48kHz/16bit/stereo sampling. With 8kHz/8bits/mono it + is possible to store 131 seconds of sound using the same amount of + memory. It is possible to reduce memory and communication costs by + compressing the recorded signal but this is out of the scope of this + document. + + 55..11.. LLooww--LLeevveell LLaayyeerr + + Audio devices are opened exclusively for a selected direction. This + doesn't allow open from more than one processes for the same audio + device in the same direction, but does allow one open call to each + playback direction and second open call to record direction + independently. Audio devices return EBUSY error to applications when + other applications have already opened the requested direction. + + Low-Level layer supports these formats: + + ______________________________________________________________________ + #define SND_PCM_SFMT_MU_LAW 0 + #define SND_PCM_SFMT_A_LAW 1 + #define SND_PCM_SFMT_IMA_ADPCM 2 + #define SND_PCM_SFMT_U8 3 + #define SND_PCM_SFMT_S16_LE 4 + #define SND_PCM_SFMT_S16_BE 5 + #define SND_PCM_SFMT_S8 6 + #define SND_PCM_SFMT_U16_LE 7 + #define SND_PCM_SFMT_U16_BE 8 + #define SND_PCM_SFMT_MPEG 9 + #define SND_PCM_SFMT_GSM 10 + + #define SND_PCM_FMT_MU_LAW (1 << SND_PCM_SFMT_MU_LAW) + #define SND_PCM_FMT_A_LAW (1 << SND_PCM_SFMT_A_LAW) + #define SND_PCM_FMT_IMA_ADPCM (1 << SND_PCM_SFMT_IMA_ADPCM) + #define SND_PCM_FMT_U8 (1 << SND_PCM_SFMT_U8) + #define SND_PCM_FMT_S16_LE (1 << SND_PCM_SFMT_S16_LE) + #define SND_PCM_FMT_S16_BE (1 << SND_PCM_SFMT_S16_BE) + #define SND_PCM_FMT_S8 (1 << SND_PCM_SFMT_S8) + #define SND_PCM_FMT_U16_LE (1 << SND_PCM_SFMT_U16_LE) + #define SND_PCM_FMT_U16_BE (1 << SND_PCM_SFMT_U16_BE) + #define SND_PCM_FMT_MPEG (1 << SND_PCM_SFMT_MPEG) + #define SND_PCM_FMT_GSM (1 << SND_PCM_SFMT_GSM) + ______________________________________________________________________ + + Constants with prefix SSNNDD__PPCCMM__FFMMTT__ are used in info structures and + constants with prefix SSNNDD__PPCCMM__SSFFMMTT__ are used in format structures. + 55..11..11.. + + iinntt ssnndd__ppccmm__ooppeenn(( vvooiidd ****hhaannddllee,, iinntt ccaarrdd,, iinntt ddeevviiccee,, iinntt mmooddee )) + + Creates a new handle and opens a connection to kernel sound audio + interface for soundcard number _c_a_r_d (0-N) and audio device number + _d_e_v_i_c_e. Function also checks if protocol is compatible to prevent use + of old programs with a new kernel API. Function returns zero if + successful,ful otherwise it returns an error code. Error code -EBUSY + is returned when some process ownes the selected direction. + + Default format after opening is mono _m_u_-_L_a_w at 8000Hz. This device can + be used directly for playback of standard .au (Sparc) files. + + The following modes should be used for the _m_o_d_e argument: + + ______________________________________________________________________ + #define SND_PCM_OPEN_PLAYBACK (O_WRONLY) + #define SND_PCM_OPEN_RECORD (O_RDONLY) + #define SND_PCM_OPEN_DUPLEX (O_RDWR) + + ______________________________________________________________________ + + 55..11..22.. + + iinntt ssnndd__ppccmm__cclloossee(( vvooiidd **hhaannddllee )) + + Frees all resources allocated with audio handle and closes the + connection to the kernel sound audio interface. Function returns zero + if successful, otherwise it returns an error code. + + 55..11..33.. + + iinntt ssnndd__ppccmm__ffiillee__ddeessccrriippttoorr(( vvooiidd **hhaannddllee )) + + Returns the file descriptor of the connection to the kernel sound + audio interface. Function returns an error code if an error was + encountered. + + The file descriptor should be used for the _s_e_l_e_c_t synchronous + multiplexer function for setting the read direction. Application + should call _s_n_d___p_c_m___r_e_a_d or _s_n_d___p_c_m___w_r_i_t_e functions if some data is + waiting for reading or a write can be performed. Calling this function + is highly recomended, as it leaves a place for the API to things like + data conversions, if needed. + + 55..11..44.. + + iinntt ssnndd__ppccmm__bblloocckk__mmooddee(( vvooiidd **hhaannddllee,, iinntt eennaabbllee )) + + Sets up block (default) or nonblock mode for a handle. Block mode + suspends execution of a program when _s_n_d___p_c_m___r_e_a_d or _s_n_d___p_c_m___w_r_i_t_e is + called for the time which is needed for the actual playback or record + over of the entire buffer. In nonblock mode, programs aren't suspended + and the above functions returns immediately with the count of bytes + which were read or written by the driver. When used in this way, don't + try to use the entire buffer after the call, but instead process the + number of bytes returned, and call the function again. + + 55..11..55.. + + iinntt ssnndd__ppccmm__iinnffoo(( vvooiidd **hhaannddllee,, ssnndd__ppccmm__iinnffoo__tt **iinnffoo )) + + Fills the *info structure with data about the PCM device selected by + *handle. Function returns zero if successful, otherwise it returns an + error code. + + ______________________________________________________________________ + #define SND_PCM_INFO_CODEC 0x00000001 + #define SND_PCM_INFO_DSP SND_PCM_INFO_CODEC + #define SND_PCM_INFO_MMAP 0x00000002 /* reserved */ + #define SND_PCM_INFO_PLAYBACK 0x00000100 + #define SND_PCM_INFO_RECORD 0x00000200 + #define SND_PCM_INFO_DUPLEX 0x00000400 + #define SND_PCM_INFO_DUPLEX_LIMIT 0x00000800 /* rate for playback & record are same */ + + struct snd_pcm_info { + unsigned int type; /* soundcard type */ + unsigned int flags; /* see SND_PCM_INFO_XXXX */ + unsigned char id[32]; /* ID of this PCM device */ + unsigned char name[80]; /* name of this device */ + unsigned char reserved[64]; /* reserved for future use */ + }; + + ______________________________________________________________________ + + SSNNDD__PPCCMM__IINNFFOO__MMMMAAPP + This flag is reserved and should be never used. It remains for + compatibility with Open Sound System driver. + + SSNNDD__PPCCMM__IINNFFOO__DDUUPPLLEEXX__LLIIMMIITT + If this bit is set, rate must be same for playback and record + direction. + + 55..11..66.. + + iinntt ssnndd__ppccmm__ppllaayybbaacckk__iinnffoo(( vvooiidd **hhaannddllee,, ssnndd__ppccmm__ppllaayybbaacckk__iinnffoo__tt **iinnffoo + )) + + Fills the *info structure with data about PCM playback. Function + returns zero if successful, otherwise it returns an error code. + + ______________________________________________________________________ + #define SND_PCM_PINFO_BATCH 0x00000001 + #define SND_PCM_PINFO_8BITONLY 0x00000002 + #define SND_PCM_PINFO_16BITONLY 0x00000004 + + struct snd_pcm_playback_info { + unsigned int flags; /* see SND_PCM_PINFO_XXXX */ + unsigned int formats; /* supported formats */ + unsigned int min_rate; /* min rate (in Hz) */ + unsigned int max_rate; /* max rate (in Hz) */ + unsigned int min_channels; /* min channels (probably always 1) */ + unsigned int max_channels; /* max channels */ + unsigned int buffer_size; /* playback buffer size */ + unsigned int min_fragment_size; /* min fragment size in bytes */ + unsigned int max_fragment_size; /* max fragment size in bytes */ + unsigned int fragment_align; /* align fragment value */ + unsigned char reserved[64]; /* reserved for future use */ + }; + + ______________________________________________________________________ + + SSNNDD__PPCCMM__PPIINNFFOO__BBAATTCCHH + Driver implements double buffering with this device. This means + that the chip used for data processing has its own memory, and + output should be more delayed than if a traditional codec chip + is used. + + SSNNDD__PPCCMM__PPIINNFFOO__88BBIITTOONNLLYY + If this bit is set, the driver uses 8-bit format for 16-bit + samples and does software conversion. This bit is set on broken + SoundBlaster 16/AWE soundcards which can't do full 16-bit + duplex. If this bit is set application or highter digital audio + layer should do the conversion from 16-bit samples to 8-bit + samples rather than making the driver to do it in the kernel. + + SSNNDD__PPCCMM__PPIINNFFOO__1166BBIITTOONNLLYY + If this bit is set, driver uses 16-bit format for 8-bit samples + and does software conversion. This bit is set on broken + SoundBlaster 16/AWE soundcards which can't do full 8-bit duplex. + If this bit is set the application or highter digital audio + layer should do conversion from 8-bit samples to 16-bit samples + rather than making the driver to do it in the kernel. + + 55..11..77.. + + iinntt ssnndd__ppccmm__rreeccoorrdd__iinnffoo(( vvooiidd **hhaannddllee,, ssnndd__ppccmm__rreeccoorrdd__iinnffoo__tt **iinnffoo )) + + Fills the *info structure. Returns zero if successful, otherwise it + returns an error code. + + ______________________________________________________________________ + #define SND_PCM_RINFO_BATCH 0x00000001 + #define SND_PCM_RINFO_8BITONLY 0x00000002 + #define SND_PCM_RINFO_16BITONLY 0x00000004 + + struct snd_pcm_record_info { + unsigned int flags; /* see to SND_PCM_RINFO_XXXX */ + unsigned int formats; /* supported formats */ + unsigned int min_rate; /* min rate (in Hz) */ + unsigned int max_rate; /* max rate (in Hz) */ + unsigned int min_channels; /* min channels (probably always 1) */ + unsigned int max_channels; /* max channels */ + unsigned int buffer_size; /* record buffer size */ + unsigned int min_fragment_size; /* min fragment size in bytes */ + unsigned int max_fragment_size; /* max fragment size in bytes */ + unsigned int fragment_align; /* align fragment value */ + unsigned char reserved[64]; /* reserved for future... */ + }; + + ______________________________________________________________________ + + SSNNDD__PPCCMM__PPIINNFFOO__BBAATTCCHH + Driver implements buffering for this device. This means that the + chip used for data processing has its own memory and output + should be more delayed than if a traditional codec chip is used. + + SSNNDD__PPCCMM__PPIINNFFOO__88BBIITTOONNLLYY + If this bit is set, the device uses 8-bit format for 16-bit + samples and does software conversion. This bit is set on broken + SoundBlaster 16/AWE soundcards which can't do full 16-bit + duplex. If this bit is set the application or highter digital + audio layer should do conversion from 16-bit samples to 8-bit + samples rather than making the driver to do it in the kernel. + + SSNNDD__PPCCMM__PPIINNFFOO__1166BBIITTOONNLLYY + If this bit is set, the device uses a 16-bit format for 8-bit + samples and does software conversion. This bit is set on broken + SoundBlaster 16/AWE soundcards which can't do full 8-bit duplex. + If this bit is set the application or highter digital audio + layer should do the conversion from 8-bit samples to 16-bit + samples rather than making the driver to do it in the kernel. + + 55..11..88.. + + iinntt ssnndd__ppccmm__ppllaayybbaacckk__ffoorrmmaatt(( vvooiidd **hhaannddllee,, ssnndd__ppccmm__ffoorrmmaatt__tt **ffoorrmmaatt )) + + Sets up format, rate (in Hz) and number of channels for playback, in + the desired direction. Function returns zero if successful, otherwise + it returns an error code. + + ______________________________________________________________________ + struct snd_pcm_format { + unsigned int format; /* SND_PCM_SFMT_XXXX */ + unsigned int rate; /* rate in Hz */ + unsigned int channels; /* channels (voices) */ + unsigned char reserved[16]; + }; + + ______________________________________________________________________ + + 55..11..99.. + + iinntt ssnndd__ppccmm__rreeccoorrdd__ffoorrmmaatt(( vvooiidd **hhaannddllee,, ssnndd__ppccmm__ffoorrmmaatt__tt **ffoorrmmaatt )) + + Sets up format, rate (in Hz) and number of channels for used for + recording in the specified direction. Function returns zero if + successful, otherwise it returns an error code. + + ______________________________________________________________________ + struct snd_pcm_format { + unsigned int format; /* SND_PCM_SFMT_XXXX */ + unsigned int rate; /* rate in Hz */ + unsigned int channels; /* channels (voices) */ + unsigned char reserved[16]; + }; + + ______________________________________________________________________ + + 55..11..1100.. + + iinntt ssnndd__ppccmm__ppllaayybbaacckk__ppaarraammss(( vvooiidd **hhaannddllee,, ssnndd__ppccmm__ppllaayybbaacckk__ppaarraammss__tt + **ppaarraammss )) + + Sets various parameters for playback direction. Function returns zero + if successful, otherwise it returns an error code. + + ______________________________________________________________________ + struct snd_pcm_playback_params { + int fragment_size; + int fragments_max; + int fragments_room; + unsigned char reserved[16]; /* must be filled with zero */ + }; + + ______________________________________________________________________ + + ffrraaggmmeenntt__ssiizzee + Requested size of fragment. This value should be aligned for + current format (for example to 4 if stereo 16-bit samples are + used) or with the _f_r_a_g_m_e_n_t___a_l_i_g_n variable from + _s_n_d___p_c_m___p_l_a_y_b_a_c_k___i_n_f_o___t structure. Its range can be from + _m_i_n___f_r_a_g_m_e_n_t___s_i_z_e to _m_a_x___f_r_a_g_m_e_n_t___s_i_z_e. + + ffrraaggmmeennttss__mmaaxx + Maximum number of fragments in queue for wakeup. This number + doesn't counts partly used fragment. If current count of filled + playback fragments is greater than this value driver block + application or return immediately back if nonblock mode is + active. + + ffrraaggmmeennttss__rroooomm + Minumum number of fragments writeable for wakeup. This value + should be in most cases 1 which means return back to application + if at least one fragment is free for playback. This value + includes partly used fragments, too. + + 55..11..1111.. + + iinntt ssnndd__ppccmm__rreeccoorrdd__ppaarraammss(( vvooiidd **hhaannddllee,, ssnndd__ppccmm__rreeccoorrdd__ppaarraammss__tt + **ppaarraammss )) + Function sets various parameters for the recording direction. Function + returns zero if successful, otherwise it returns an error code. + + ______________________________________________________________________ + struct snd_pcm_record_params { + int fragment_size; + int fragments_min; + unsigned char reserved[16]; + }; + + ______________________________________________________________________ + + ffrraaggmmeenntt__ssiizzee + Requested size of fragment. This value should be aligned for + current format (for example to 4 if stereo 16-bit samples are + used) or set to the _f_r_a_g_m_e_n_t___a_l_i_g_n variable from + _s_n_d___p_c_m___p_l_a_y_b_a_c_k___i_n_f_o___t structure. Its range can be from + _m_i_n___f_r_a_g_m_e_n_t___s_i_z_e to _m_a_x___f_r_a_g_m_e_n_t___s_i_z_e. + + ffrraaggmmeennttss__mmiinn + Minimum filled fragments for wakeup. Driver blocks the + application (if block mode is selected) until it isn't filled + with number of fragments specified with this value. + + 55..11..1122.. + + iinntt ssnndd__ppccmm__ppllaayybbaacckk__ssttaattuuss(( vvooiidd **hhaannddllee,, ssnndd__ppccmm__ppllaayybbaacckk__ssttaattuuss__tt + **ssttaattuuss )) + + Fills the *status structure. Function returns zero if successful, + otherwise it returns an error code. + + ______________________________________________________________________ + struct snd_pcm_playback_status { + unsigned int rate; + int fragments; + int fragment_size; + int count; + int queue; + int underrun; + struct timeval time; + struct timeval stime; + unsigned char reserved[16]; + }; + + ______________________________________________________________________ + + rraattee + Real playback rate. This value reflects hardware limitations. + + ffrraaggmmeennttss + Currently allocated fragments by the driver for playback + direction. + + ffrraaggmmeenntt__ssiizzee + Current fragment size used by driver for the playback direction. + + ccoouunntt + Count of bytes writeable without blocking. + + qquueeuuee + Count of bytes in queue. Note: _(_f_r_a_g_m_e_n_t_s _* _f_r_a_g_m_e_n_t___s_i_z_e_) _- + _q_u_e_u_e should not be equal to _c_o_u_n_t. + + uunnddeerrrruunn + This value tells the application the number of underruns since + the ast call of _s_n_d___p_c_m___p_l_a_y_b_a_c_k___s_t_a_t_u_s. + + ttiimmee + Delay till played of the first sample from next write. This + value should be used for time synchronization. Returned value is + in the same format as returned from the standard C function + _g_e_t_t_i_m_e_o_f_d_a_y_( _&_t_i_m_e_, _N_U_L_L _). This variable contains right value + only if playback time mode is enabled (look to + _s_n_d___p_c_m___p_l_a_y_b_a_c_k___t_i_m_e function). + + ssttiimmee + Time when playback was started. This variable contains right + value only if playback time mode is enabled (look to + _s_n_d___p_c_m___p_l_a_y_b_a_c_k___t_i_m_e function). + + 55..11..1133.. + + iinntt ssnndd__ppccmm__rreeccoorrdd__ssttaattuuss(( vvooiidd **hhaannddllee,, ssnndd__ppccmm__rreeccoorrdd__ssttaattuuss__tt **ssttaa-- + ttuuss )) + + Fills the *status structure. Function returns zero if successful, + otherwise it returns an error code. + + ______________________________________________________________________ + struct snd_pcm_record_status { + unsigned int rate; + int fragments; + int fragment_size; + int count; + int free; + int overrun; + struct timeval time; + unsigned char reserved[16]; + }; + + ______________________________________________________________________ + + rraattee + Real record rate. This value reflects hardware limitations. + + ffrraaggmmeennttss + Currently allocated fragments by driver for the record + direction. + + ffrraaggmmeenntt__ssiizzee + Current fragment size used by driver for the record direction. + + ccoouunntt + Count of bytes readable without blocking. + + ffrreeee + Count of bytes in buffer still free. Note: _(_f_r_a_g_m_e_n_t_s _* + _f_r_a_g_m_e_n_t___s_i_z_e_) _- _f_r_e_e should not be equal to _c_o_u_n_t. + + oovveerrrruunn + This value tells application the count of overruns since the + last call to _s_n_d___p_c_m___r_e_c_o_r_d___s_t_a_t_u_s. + ttiimmee + Lag since the next sample read was recorded. This value should + be used for time synchronization. Returned value is in the same + format as returned by the from standard C function _g_e_t_t_i_m_e_o_f_d_a_y_( + _&_t_i_m_e_, _N_U_L_L _). This variable contains right value only if record + time mode is enabled (look to _s_n_d___p_c_m___r_e_c_o_r_d___t_i_m_e function). + + ssttiimmee + Time when record was started. This variable contains right value + only if record time mode is enabled (look to _s_n_d___p_c_m___r_e_c_o_r_d___t_i_m_e + function). + + 55..11..1144.. + + iinntt ssnndd__ppccmm__ddrraaiinn__ppllaayybbaacckk(( vvooiidd **hhaannddllee )) + + This function drain playback buffers immediately. Function returns + zero if successful, otherwise it returns an error code. + + 55..11..1155.. + + iinntt ssnndd__ppccmm__fflluusshh__ppllaayybbaacckk(( vvooiidd **hhaannddllee )) + + This function flushes the playback buffers. It blocks the program + while the all the waiting samples in kernel playback buffers are + processed. Function returns zero if successful, otherwise it returns + an error code. + + 55..11..1166.. + + iinntt ssnndd__ppccmm__fflluusshh__rreeccoorrdd(( vvooiidd **hhaannddllee )) + + This function flushes (destroyes) record buffers. Function returns + zero if successful, otherwise it returns an error code. + + 55..11..1177.. + + iinntt ssnndd__ppccmm__ppllaayybbaacckk__ttiimmee(( vvooiidd **hhaannddllee,, iinntt eennaabbllee )) + + This function enables or disables time mode for playback direction. + Time mode allows to application better time synchronization. Function + returns zero if successful, otherwise it returns an error code. + + 55..11..1188.. + + iinntt ssnndd__ppccmm__rreeccoorrdd__ttiimmee(( vvooiidd **hhaannddllee,, iinntt eennaabbllee )) + + This function enables or disables time mode for record direction. Time + mode allows to application better time synchronization. Function + returns zero if successful, otherwise it returns an error code. + + 55..11..1199.. + + ssssiizzee__tt ssnndd__ppccmm__wwrriittee(( vvooiidd **hhaannddllee,, ccoonnsstt vvooiidd **bbuuffffeerr,, ssiizzee__tt ssiizzee )) + + Writes samples to the device which must be in the proper format + specified by the _s_n_d___p_c_m___p_l_a_y_b_a_c_k___f_o_r_m_a_t function. Function returns + zero or positive value if playback was successful (value represents + count of bytes which was successfuly written to device) or an error + value if error occured. Function should suspend process if block mode + is active. + + 55..11..2200.. + + ssssiizzee__tt ssnndd__ppccmm__rreeaadd(( vvooiidd **hhaannddllee,, vvooiidd **bbuuffffeerr,, ssiizzee__tt ssiizzee )) + + Function reads samples from driver. Samples are in format specified by + _s_n_d___p_c_m___r_e_c_o_r_d___f_o_r_m_a_t function. Function returns zero or positive + value if record was success (value represents count of bytes which was + successfuly read from device) or negative error value if error + occured. Function should suspend process if block mode is active. + + 55..22.. EExxaammpplleess + + The following example shows how to play the first 512kB from the + /tmp/test.au file with soundcard #0 and PCM device #0: + + ______________________________________________________________________ + int card = 0, device = 0, err, fd, count, size, idx; + void *handle; + snd_pcm_format_t format; + char *buffer; + + buffer = (char *)malloc( 512 * 1024 ); + if ( !buffer ) return; + if ( (err = snd_pcm_open( &handle, card, device, SND_PCM_OPEN_PLAYBACK )) < 0 ) { + fprintf( stderr, "open failed: %s\n", snd_strerror( err ) ); + return; + } + format.format = SND_PCM_SFMT_MU_LAW; + format.rate = 8000; + format.voices = 1; + if ( (err = snd_pcm_playback_format( handle, &format )) < 0 ) { + fprintf( stderr, "format setup failed: %s\n", snd_strerror( err ) ); + snd_pcm_close( handle ); + return; + } + fd = open( "/tmp/test.au" ); + if ( fd < 0 ) { + perror( "open file" ); + snd_pcm_close( handle ); + return; + } + idx = 0; + count = read( fd, buffer, 512 * 1024 ); + if ( count <= 0 ) { + perror( "read from file" ); + snd_pcm_close( handle ); + return; + } + close( fd ); + if ( !memcmp( buffer, ".snd", 4 ) ) { + idx = (buffer[4]<<24)|(buffer[5]<<16)|(buffer[6]<<8)|(buffer[7]); + if ( idx > 128 ) idx = 128; + if ( idx > count ) idx = count; + } + size = snd_pcm_write( handle, &buffer[ idx ], count - idx ); + printf( "Bytes written %i from %i...\n", size, count - idx ); + snd_pcm_close( handle ); + free( buffer ); + ______________________________________________________________________ + diff --git a/include/Makefile b/include/Makefile new file mode 100644 index 00000000..d9e97658 --- /dev/null +++ b/include/Makefile @@ -0,0 +1,10 @@ +# +# Makefile for ALSA library +# Copyright (c) 1994-98 by Jaroslav Kysela <perex@jcu.cz> +# + +include ../Makefile.conf + +clean: + rm -f core .depend *.o *.orig *~ + diff --git a/include/config.h b/include/config.h new file mode 100644 index 00000000..b6845796 --- /dev/null +++ b/include/config.h @@ -0,0 +1,7 @@ +/* include/config.h. Generated automatically by configure. */ +/* + * Configuration header file for compilation of the ALSA driver + */ + +#define SND_LIB_VERSION "0.0.9" +/* #undef WORDS_BIGENDIAN */ diff --git a/include/config.h.in b/include/config.h.in new file mode 100644 index 00000000..b6042e02 --- /dev/null +++ b/include/config.h.in @@ -0,0 +1,6 @@ +/* + * Configuration header file for compilation of the ALSA driver + */ + +#undef SND_LIB_VERSION +#undef WORDS_BIGENDIAN diff --git a/include/control.h b/include/control.h new file mode 100644 index 00000000..56114990 --- /dev/null +++ b/include/control.h @@ -0,0 +1,28 @@ +/**************************************************************************** + * * + * control.h * + * Control Interface * + * * + ****************************************************************************/ + +#ifdef __cplusplus +extern "C" { +#endif + +int snd_cards( void ); +unsigned int snd_cards_mask( void ); +int snd_card_name( const char *name ); + +int snd_ctl_open( void **handle, int card ); +int snd_ctl_close( void *handle ); +int snd_ctl_file_descriptor( void *handle ); +int snd_ctl_hw_info( void *handle, struct snd_ctl_hw_info *info ); +int snd_ctl_pcm_info( void *handle, int dev, snd_pcm_info_t *info ); +int snd_ctl_pcm_playback_info( void *handle, int dev, snd_pcm_playback_info_t *info ); +int snd_ctl_pcm_record_info( void *handle, int dev, snd_pcm_record_info_t *info ); +int snd_ctl_mixer_info( void *handle, int dev, snd_mixer_info_t *info ); + +#ifdef __cplusplus +} +#endif + diff --git a/include/error.h b/include/error.h new file mode 100644 index 00000000..fe4adca6 --- /dev/null +++ b/include/error.h @@ -0,0 +1,17 @@ +/* + * error.h + */ + +#define SND_ERROR_BEGIN 500000 +#define SND_ERROR_UNCOMPATIBLE_VERSION (SND_ERROR_BEGIN+0) + +#ifdef __cplusplus +extern "C" { +#endif + +const char *snd_strerror( int errnum ); + +#ifdef __cplusplus +} +#endif + diff --git a/include/footer.h b/include/footer.h new file mode 100644 index 00000000..d4cc0a02 --- /dev/null +++ b/include/footer.h @@ -0,0 +1,5 @@ +/* + * + */ + +#endif /* __SOUNDLIB_H */ diff --git a/include/header.h b/include/header.h new file mode 100644 index 00000000..f0cab83e --- /dev/null +++ b/include/header.h @@ -0,0 +1,27 @@ +/* + * Application interface library for the ALSA driver + * Copyright (c) by Jaroslav Kysela <perex@jcu.cz> + * + * + * This library is free software; you can redistribute it and/or modify + * it under the terms of the GNU Library General Public License as + * published by the Free Software Foundation; either version 2 of + * the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ + +#ifndef __SOUNDLIB_H +#define __SOUNDLIB_H + +#include <linux/sound.h> +#include <unistd.h> + diff --git a/include/local.h b/include/local.h new file mode 100644 index 00000000..eeb07765 --- /dev/null +++ b/include/local.h @@ -0,0 +1,240 @@ +/* + * Application interface library for the ALSA driver + * Copyright (c) 1994/98 by Jaroslav Kysela <perex@jcu.cz> + */ + +#include <asm/byteorder.h> +#include "../../../include/ultraconf.h" + +#ifdef DEBUG + +#include <assert.h> +#define ASSERT( s ) assert( s ) + +void __snd_dprintf( char *, ... ); +#define snd_dprintf( args... ) __ultra_dprintf( ##args ) + +#else + +#define ASSERT( s ) { ; } + +#define snd_dprintf( fmt... ) /* nothing */ + +#endif + +extern inline int snd_p_rint( float x ) +{ + return (int)( x + (float)0.5 ); +} + +/* + * + */ + +extern inline void snd_put_byte( unsigned char *array, unsigned int idx, unsigned char b ) +{ + *(array + idx) = b; +} + +extern inline unsigned char snd_get_byte( unsigned char *array, unsigned int idx ) +{ + return *(array + idx); +} + +#if defined( __i386__ ) + +extern inline void snd_put_le_word( unsigned char *array, unsigned int idx, unsigned short w ) +{ + *(unsigned short *)(array + idx) = w; +} + +extern inline unsigned short snd_get_le_word( unsigned char *array, unsigned int idx ) +{ + return *(unsigned short *)(array + idx); +} + +extern inline void snd_put_le_dword( unsigned char *array, unsigned int idx, unsigned int dw ) +{ + *(unsigned int *)(array + idx) = dw; +} + +extern inline unsigned int snd_get_le_dword( unsigned char *array, unsigned int idx ) +{ + return *(unsigned int *)(array + idx ); +} + +#else + +#ifndef WORDS_BIGENDIAN + +extern inline void snd_put_le_word( unsigned char *array, unsigned int idx, unsigned short w ) +{ + *(array + idx + 0) = (unsigned char)(w >> 0); + *(array + idx + 1) = (unsigned char)(w >> 8); +} + +extern inline unsigned short snd_get_le_word( unsigned char *array, unsigned int idx ) +{ + return ( *(array + idx + 0) << 0 ) | + ( *(array + idx + 1) << 8 ); +} + +extern inline void snd_put_le_dword( unsigned char *array, unsigned int idx, unsigned int dw ) +{ + *(array + idx + 0) = (unsigned char)(dw >> 0); + *(array + idx + 1) = (unsigned char)(dw >> 8); + *(array + idx + 2) = (unsigned char)(dw >> 16); + *(array + idx + 3) = (unsigned char)(dw >> 24); +} + +extern inline unsigned int snd_get_le_dword( unsigned char *array, unsigned int idx ) +{ + return ( *(array + idx + 0) << 0 ) | + ( *(array + idx + 1) << 8 ) | + ( *(array + idx + 2) << 16 ) | + ( *(array + idx + 3) << 24 ); +} + +#else + +extern inline void snd_put_le_word( unsigned char *array, unsigned int idx, unsigned short w ) +{ + *(array + idx + 0) = (unsigned char)(w >> 8); + *(array + idx + 1) = (unsigned char)(w >> 0); +} + +extern inline unsigned short snd_get_le_word( unsigned char *array, unsigned int idx ) +{ + return ( *(array + idx + 0) << 8 ) | + ( *(array + idx + 1) << 0 ); +} + +extern inline void snd_put_le_dword( unsigned char *array, unsigned int idx, unsigned int dw ) +{ + *(array + idx + 0) = (unsigned char)(dw >> 24); + *(array + idx + 1) = (unsigned char)(dw >> 16); + *(array + idx + 2) = (unsigned char)(dw >> 8); + *(array + idx + 3) = (unsigned char)(dw >> 0); +} + +extern inline unsigned int snd_get_le_dword( unsigned char *array, unsigned int idx ) +{ + return ( *(array + idx + 0) << 24 ) | + ( *(array + idx + 1) << 16 ) | + ( *(array + idx + 2) << 8 ) | + ( *(array + idx + 3) << 0 ); +} + +#endif + +#endif + +/* + * + */ + +extern inline unsigned char snd_get_unsigned_byte( unsigned char *ptr ) +{ + return *ptr; +} + +extern inline void snd_put_unsigned_byte( unsigned char *ptr, unsigned char val ) +{ + *ptr = val; +} + +extern inline unsigned char snd_get_signed_byte( signed char *ptr ) +{ + return *ptr; +} + +extern inline void snd_put_signed_byte( signed char *ptr, signed char val ) +{ + *ptr = val; +} + +#if !defined( WORDS_BIGENDIAN ) || defined( __i386__ ) + +extern inline signed short snd_get_signed_le_word( unsigned char *ptr ) +{ + return *(signed short *)ptr; +} + +extern inline void snd_put_signed_le_word( unsigned char *ptr, signed short val ) +{ + *(signed short *)ptr = val; +} + +extern inline unsigned short snd_get_unsigned_le_word( unsigned char *ptr ) +{ + return *(unsigned short *)ptr; +} + +extern inline void snd_put_unsigned_le_word( unsigned char *ptr, unsigned short val ) +{ + *(unsigned short *)ptr = val; +} + +extern inline unsigned int snd_get_unsigned_le_dword( unsigned char *ptr ) +{ + return *(unsigned int *)ptr; +} + +extern inline void snd_put_unsigned_le_dword( unsigned char *ptr, unsigned int val ) +{ + *(unsigned int *)ptr = val; +} + +#else + +extern inline unsigned short snd_get_signed_le_word( unsigned char *ptr ) +{ + return (signed short)( *ptr + ( *( ptr + 1 ) << 8 ); +} + +extern inline void snd_put_signed_le_word( unsigned char *ptr, signed short val ) +{ + *ptr = (unsigned char)val; + *(ptr + 1) = val >> 8; +} + +extern inline unsigned short snd_get_unsigned_le_word( unsigned char *ptr ) +{ + return (signed short)( *ptr + ( *( ptr + 1 ) << 8 ); +} + +extern inline void snd_put_unsigned_le_word( unsigned char *ptr, unsigned short val ) +{ + *ptr = (unsigned char)val; + *(ptr + 1) = val >> 8; +} + +extern inline unsigned int snd_get_unsigned_le_dword( unsigned char *ptr ) +{ + return (signed int)( *ptr + ( *( ptr + 1 ) << 8 ) + + ( *( ptr + 2 ) << 8 ) + ( *( ptr + 3 ) << 8 ) ); +} + +extern inline void snd_put_unsigned_le_dword( unsigned char *ptr, unsigned int val ) +{ + *ptr = (unsigned char)val; + *(ptr + 1) = (unsigned char)val >> 8; + *(ptr + 2) = (unsigned char)val >> 16; + *(ptr + 3) = (unsigned char)val >> 24; +} + +#endif + +extern inline unsigned short snd_get_be_word( unsigned char *array, unsigned int idx ) +{ + return ( *(array + idx + 1) << 0 ) | + ( *(array + idx + 0) << 8 ); +} + +extern inline unsigned int snd_get_be_dword( unsigned char *array, unsigned int idx ) +{ + return ( *(array + idx + 3) << 0 ) | + ( *(array + idx + 2) << 8 ) | + ( *(array + idx + 1) << 16 ) | + ( *(array + idx + 0) << 24 ); +} diff --git a/include/mixer.h b/include/mixer.h new file mode 100644 index 00000000..38c0024d --- /dev/null +++ b/include/mixer.h @@ -0,0 +1,35 @@ +/**************************************************************************** + * * + * mixer.h * + * Mixer Interface * + * * + ****************************************************************************/ + +typedef struct snd_mixer_callbacks { + void *private_data; /* should be used by application */ + void (*channel_was_changed)( void *private_data, int channel ); + void *reserved[15]; /* reserved for future use - must be NULL!!! */ +} snd_mixer_callbacks_t; + +#ifdef __cplusplus +extern "C" { +#endif + +int snd_mixer_open( void **handle, int card, int device ); +int snd_mixer_close( void *handle ); +int snd_mixer_file_descriptor( void *handle ); +int snd_mixer_channels( void *handle ); +int snd_mixer_info( void *handle, snd_mixer_info_t *info ); +int snd_mixer_exact_mode( void *handle, int enable ); +int snd_mixer_channel( void *handle, const char *channel_id ); +int snd_mixer_channel_info( void *handle, int channel, snd_mixer_channel_info_t *info ); +int snd_mixer_channel_read( void *handle, int channel, snd_mixer_channel_t *data ); +int snd_mixer_channel_write( void *handle, int channel, snd_mixer_channel_t *data ); +int snd_mixer_special_read( void *handle, snd_mixer_special_t *special ); +int snd_mixer_special_write( void *handle, snd_mixer_special_t *special ); +int snd_mixer_read( void *handle, snd_mixer_callbacks_t *callbacks ); + +#ifdef __cplusplus +} +#endif + diff --git a/include/pcm.h b/include/pcm.h new file mode 100644 index 00000000..c1065f99 --- /dev/null +++ b/include/pcm.h @@ -0,0 +1,40 @@ +/**************************************************************************** + * * + * pcm.h * + * Digital Audio Interface * + * * + ****************************************************************************/ + +#define SND_PCM_OPEN_PLAYBACK (O_WRONLY) +#define SND_PCM_OPEN_RECORD (O_RDONLY) +#define SND_PCM_OPEN_DUPLEX (O_RDWR) + +#ifdef __cplusplus +extern "C" { +#endif + +int snd_pcm_open( void **handle, int card, int device, int mode ); +int snd_pcm_close( void *handle ); +int snd_pcm_file_descriptor( void *handle ); +int snd_pcm_block_mode( void *handle, int enable ); +int snd_pcm_info( void *handle, snd_pcm_info_t *info ); +int snd_pcm_playback_info( void *handle, snd_pcm_playback_info_t *info ); +int snd_pcm_record_info( void *handle, snd_pcm_record_info_t *info ); +int snd_pcm_playback_format( void *handle, snd_pcm_format_t *format ); +int snd_pcm_record_format( void *handle, snd_pcm_format_t *format ); +int snd_pcm_playback_params( void *handle, snd_pcm_playback_params_t *params ); +int snd_pcm_record_params( void *handle, snd_pcm_record_params_t *params ); +int snd_pcm_playback_status( void *handle, snd_pcm_playback_status_t *status ); +int snd_pcm_record_status( void *handle, snd_pcm_record_status_t *status ); +int snd_pcm_drain_playback( void *handle ); +int snd_pcm_flush_playback( void *handle ); +int snd_pcm_flush_record( void *handle ); +int snd_pcm_playback_time( void *handle, int enable ); +int snd_pcm_record_time( void *handle, int enable ); +ssize_t snd_pcm_write( void *handle, const void *buffer, size_t size ); +ssize_t snd_pcm_read( void *handle, void *buffer, size_t size ); + +#ifdef __cplusplus +} +#endif + diff --git a/include/soundlib.h b/include/soundlib.h new file mode 100644 index 00000000..681fe40b --- /dev/null +++ b/include/soundlib.h @@ -0,0 +1,161 @@ +/* + * Application interface library for the ALSA driver + * Copyright (c) by Jaroslav Kysela <perex@jcu.cz> + * + * + * This library is free software; you can redistribute it and/or modify + * it under the terms of the GNU Library General Public License as + * published by the Free Software Foundation; either version 2 of + * the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ + +#ifndef __SOUNDLIB_H +#define __SOUNDLIB_H + +#include <linux/sound.h> +#include <unistd.h> + +/* + * version.h + */ + +#define SOUNDLIB_VERSION_MAJOR 0 +#define SOUNDLIB_VERSION_MINOR 0 +#define SOUNDLIB_VERSION_SUBMINOR 9 +#define SOUNDLIB_VERSION ( ( LIBULTRA_VERSION_MAJOR << 16 ) | ( LIBULTRA_VERSION_MINOR << 8 ) | LIB_ULTRA_VERSION_SUBMINOR ) + +/* + * error.h + */ + +#define SND_ERROR_BEGIN 500000 +#define SND_ERROR_UNCOMPATIBLE_VERSION (SND_ERROR_BEGIN+0) + +#ifdef __cplusplus +extern "C" { +#endif + +const char *snd_strerror( int errnum ); + +#ifdef __cplusplus +} +#endif + +/**************************************************************************** + * * + * control.h * + * Control Interface * + * * + ****************************************************************************/ + +#ifdef __cplusplus +extern "C" { +#endif + +int snd_cards( void ); +unsigned int snd_cards_mask( void ); +int snd_card_name( const char *name ); + +int snd_ctl_open( void **handle, int card ); +int snd_ctl_close( void *handle ); +int snd_ctl_file_descriptor( void *handle ); +int snd_ctl_hw_info( void *handle, struct snd_ctl_hw_info *info ); +int snd_ctl_pcm_info( void *handle, int dev, snd_pcm_info_t *info ); +int snd_ctl_pcm_playback_info( void *handle, int dev, snd_pcm_playback_info_t *info ); +int snd_ctl_pcm_record_info( void *handle, int dev, snd_pcm_record_info_t *info ); +int snd_ctl_mixer_info( void *handle, int dev, snd_mixer_info_t *info ); + +#ifdef __cplusplus +} +#endif + +/**************************************************************************** + * * + * mixer.h * + * Mixer Interface * + * * + ****************************************************************************/ + +typedef struct snd_mixer_callbacks { + void *private_data; /* should be used by application */ + void (*channel_was_changed)( void *private_data, int channel ); + void *reserved[15]; /* reserved for future use - must be NULL!!! */ +} snd_mixer_callbacks_t; + +#ifdef __cplusplus +extern "C" { +#endif + +int snd_mixer_open( void **handle, int card, int device ); +int snd_mixer_close( void *handle ); +int snd_mixer_file_descriptor( void *handle ); +int snd_mixer_channels( void *handle ); +int snd_mixer_info( void *handle, snd_mixer_info_t *info ); +int snd_mixer_exact_mode( void *handle, int enable ); +int snd_mixer_channel( void *handle, const char *channel_id ); +int snd_mixer_channel_info( void *handle, int channel, snd_mixer_channel_info_t *info ); +int snd_mixer_channel_read( void *handle, int channel, snd_mixer_channel_t *data ); +int snd_mixer_channel_write( void *handle, int channel, snd_mixer_channel_t *data ); +int snd_mixer_special_read( void *handle, snd_mixer_special_t *special ); +int snd_mixer_special_write( void *handle, snd_mixer_special_t *special ); +int snd_mixer_read( void *handle, snd_mixer_callbacks_t *callbacks ); + +#ifdef __cplusplus +} +#endif + +/**************************************************************************** + * * + * pcm.h * + * Digital Audio Interface * + * * + ****************************************************************************/ + +#define SND_PCM_OPEN_PLAYBACK (O_WRONLY) +#define SND_PCM_OPEN_RECORD (O_RDONLY) +#define SND_PCM_OPEN_DUPLEX (O_RDWR) + +#ifdef __cplusplus +extern "C" { +#endif + +int snd_pcm_open( void **handle, int card, int device, int mode ); +int snd_pcm_close( void *handle ); +int snd_pcm_file_descriptor( void *handle ); +int snd_pcm_block_mode( void *handle, int enable ); +int snd_pcm_info( void *handle, snd_pcm_info_t *info ); +int snd_pcm_playback_info( void *handle, snd_pcm_playback_info_t *info ); +int snd_pcm_record_info( void *handle, snd_pcm_record_info_t *info ); +int snd_pcm_playback_format( void *handle, snd_pcm_format_t *format ); +int snd_pcm_record_format( void *handle, snd_pcm_format_t *format ); +int snd_pcm_playback_params( void *handle, snd_pcm_playback_params_t *params ); +int snd_pcm_record_params( void *handle, snd_pcm_record_params_t *params ); +int snd_pcm_playback_status( void *handle, snd_pcm_playback_status_t *status ); +int snd_pcm_record_status( void *handle, snd_pcm_record_status_t *status ); +int snd_pcm_drain_playback( void *handle ); +int snd_pcm_flush_playback( void *handle ); +int snd_pcm_flush_record( void *handle ); +int snd_pcm_playback_time( void *handle, int enable ); +int snd_pcm_record_time( void *handle, int enable ); +ssize_t snd_pcm_write( void *handle, const void *buffer, size_t size ); +ssize_t snd_pcm_read( void *handle, void *buffer, size_t size ); + +#ifdef __cplusplus +} +#endif + +/* + * + */ + +#endif /* __SOUNDLIB_H */ diff --git a/include/version.h b/include/version.h new file mode 100644 index 00000000..8e0e73cb --- /dev/null +++ b/include/version.h @@ -0,0 +1,9 @@ +/* + * version.h + */ + +#define SOUNDLIB_VERSION_MAJOR 0 +#define SOUNDLIB_VERSION_MINOR 0 +#define SOUNDLIB_VERSION_SUBMINOR 9 +#define SOUNDLIB_VERSION ( ( LIBULTRA_VERSION_MAJOR << 16 ) | ( LIBULTRA_VERSION_MINOR << 8 ) | LIB_ULTRA_VERSION_SUBMINOR ) + diff --git a/include/version.h.in b/include/version.h.in new file mode 100644 index 00000000..0a4ac282 --- /dev/null +++ b/include/version.h.in @@ -0,0 +1,9 @@ +/* + * version.h + */ + +#define SOUNDLIB_VERSION_MAJOR @SND_LIB_MAJOR@ +#define SOUNDLIB_VERSION_MINOR @SND_LIB_MINOR@ +#define SOUNDLIB_VERSION_SUBMINOR @SND_LIB_SUBMINOR@ +#define SOUNDLIB_VERSION ( ( LIBULTRA_VERSION_MAJOR << 16 ) | ( LIBULTRA_VERSION_MINOR << 8 ) | LIB_ULTRA_VERSION_SUBMINOR ) + diff --git a/install-sh b/install-sh new file mode 100644 index 00000000..ebc66913 --- /dev/null +++ b/install-sh @@ -0,0 +1,250 @@ +#! /bin/sh +# +# install - install a program, script, or datafile +# This comes from X11R5 (mit/util/scripts/install.sh). +# +# Copyright 1991 by the Massachusetts Institute of Technology +# +# Permission to use, copy, modify, distribute, and sell this software and its +# documentation for any purpose is hereby granted without fee, provided that +# the above copyright notice appear in all copies and that both that +# copyright notice and this permission notice appear in supporting +# documentation, and that the name of M.I.T. not be used in advertising or +# publicity pertaining to distribution of the software without specific, +# written prior permission. M.I.T. makes no representations about the +# suitability of this software for any purpose. It is provided "as is" +# without express or implied warranty. +# +# Calling this script install-sh is preferred over install.sh, to prevent +# `make' implicit rules from creating a file called install from it +# when there is no Makefile. +# +# This script is compatible with the BSD install script, but was written +# from scratch. It can only install one file at a time, a restriction +# shared with many OS's install programs. + + +# set DOITPROG to echo to test this script + +# Don't use :- since 4.3BSD and earlier shells don't like it. +doit="${DOITPROG-}" + + +# put in absolute paths if you don't have them in your path; or use env. vars. + +mvprog="${MVPROG-mv}" +cpprog="${CPPROG-cp}" +chmodprog="${CHMODPROG-chmod}" +chownprog="${CHOWNPROG-chown}" +chgrpprog="${CHGRPPROG-chgrp}" +stripprog="${STRIPPROG-strip}" +rmprog="${RMPROG-rm}" +mkdirprog="${MKDIRPROG-mkdir}" + +transformbasename="" +transform_arg="" +instcmd="$mvprog" +chmodcmd="$chmodprog 0755" +chowncmd="" +chgrpcmd="" +stripcmd="" +rmcmd="$rmprog -f" +mvcmd="$mvprog" +src="" +dst="" +dir_arg="" + +while [ x"$1" != x ]; do + case $1 in + -c) instcmd="$cpprog" + shift + continue;; + + -d) dir_arg=true + shift + continue;; + + -m) chmodcmd="$chmodprog $2" + shift + shift + continue;; + + -o) chowncmd="$chownprog $2" + shift + shift + continue;; + + -g) chgrpcmd="$chgrpprog $2" + shift + shift + continue;; + + -s) stripcmd="$stripprog" + shift + continue;; + + -t=*) transformarg=`echo $1 | sed 's/-t=//'` + shift + continue;; + + -b=*) transformbasename=`echo $1 | sed 's/-b=//'` + shift + continue;; + + *) if [ x"$src" = x ] + then + src=$1 + else + # this colon is to work around a 386BSD /bin/sh bug + : + dst=$1 + fi + shift + continue;; + esac +done + +if [ x"$src" = x ] +then + echo "install: no input file specified" + exit 1 +else + true +fi + +if [ x"$dir_arg" != x ]; then + dst=$src + src="" + + if [ -d $dst ]; then + instcmd=: + else + instcmd=mkdir + fi +else + +# Waiting for this to be detected by the "$instcmd $src $dsttmp" command +# might cause directories to be created, which would be especially bad +# if $src (and thus $dsttmp) contains '*'. + + if [ -f $src -o -d $src ] + then + true + else + echo "install: $src does not exist" + exit 1 + fi + + if [ x"$dst" = x ] + then + echo "install: no destination specified" + exit 1 + else + true + fi + +# If destination is a directory, append the input filename; if your system +# does not like double slashes in filenames, you may need to add some logic + + if [ -d $dst ] + then + dst="$dst"/`basename $src` + else + true + fi +fi + +## this sed command emulates the dirname command +dstdir=`echo $dst | sed -e 's,[^/]*$,,;s,/$,,;s,^$,.,'` + +# Make sure that the destination directory exists. +# this part is taken from Noah Friedman's mkinstalldirs script + +# Skip lots of stat calls in the usual case. +if [ ! -d "$dstdir" ]; then +defaultIFS=' +' +IFS="${IFS-${defaultIFS}}" + +oIFS="${IFS}" +# Some sh's can't handle IFS=/ for some reason. +IFS='%' +set - `echo ${dstdir} | sed -e 's@/@%@g' -e 's@^%@/@'` +IFS="${oIFS}" + +pathcomp='' + +while [ $# -ne 0 ] ; do + pathcomp="${pathcomp}${1}" + shift + + if [ ! -d "${pathcomp}" ] ; + then + $mkdirprog "${pathcomp}" + else + true + fi + + pathcomp="${pathcomp}/" +done +fi + +if [ x"$dir_arg" != x ] +then + $doit $instcmd $dst && + + if [ x"$chowncmd" != x ]; then $doit $chowncmd $dst; else true ; fi && + if [ x"$chgrpcmd" != x ]; then $doit $chgrpcmd $dst; else true ; fi && + if [ x"$stripcmd" != x ]; then $doit $stripcmd $dst; else true ; fi && + if [ x"$chmodcmd" != x ]; then $doit $chmodcmd $dst; else true ; fi +else + +# If we're going to rename the final executable, determine the name now. + + if [ x"$transformarg" = x ] + then + dstfile=`basename $dst` + else + dstfile=`basename $dst $transformbasename | + sed $transformarg`$transformbasename + fi + +# don't allow the sed command to completely eliminate the filename + + if [ x"$dstfile" = x ] + then + dstfile=`basename $dst` + else + true + fi + +# Make a temp file name in the proper directory. + + dsttmp=$dstdir/#inst.$$# + +# Move or copy the file name to the temp name + + $doit $instcmd $src $dsttmp && + + trap "rm -f ${dsttmp}" 0 && + +# and set any options; do chmod last to preserve setuid bits + +# If any of these fail, we abort the whole thing. If we want to +# ignore errors from any of these, just make sure not to ignore +# errors from the above "$doit $instcmd $src $dsttmp" command. + + if [ x"$chowncmd" != x ]; then $doit $chowncmd $dsttmp; else true;fi && + if [ x"$chgrpcmd" != x ]; then $doit $chgrpcmd $dsttmp; else true;fi && + if [ x"$stripcmd" != x ]; then $doit $stripcmd $dsttmp; else true;fi && + if [ x"$chmodcmd" != x ]; then $doit $chmodcmd $dsttmp; else true;fi && + +# Now rename the file to the real destination. + + $doit $rmcmd -f $dstdir/$dstfile && + $doit $mvcmd $dsttmp $dstdir/$dstfile + +fi && + + +exit 0 diff --git a/src/Makefile b/src/Makefile new file mode 100644 index 00000000..1eadfae3 --- /dev/null +++ b/src/Makefile @@ -0,0 +1,74 @@ +# +# Makefile for ALSA library +# Copyright (c) 1994-98 by Jaroslav Kysela <perex@jcu.cz> +# + +include ../Makefile.conf + +TARGET=../lib/libsound.a +STARGET=../lib/libsound.so +STARGETX=../lib/libsound.so.$(SND_LIB_VERSION) +STARGETO=../lib/libsound.so.$(SND_LIB_MAJOR) +TARGETS=$(TARGET) $(STARGET) + +STATIC_LIBS= control/libcontrol.a \ + mixer/libmixer.a \ + pcm/libpcm.a +DYNAMIC_LIBS= control/libcontrol.Sa \ + mixer/libmixer.Sa \ + pcm/libpcm.Sa + +OBJECTS=error.o +SOBJECTS=error.So + +.SUFFIXES: +.SUFFIXES: .c .s .S .o .So .a .Sa + +.c.o: + $(CC) $(COPTS) $(INCLUDE) -c -o $*.o $< +.c.So: + $(CC) $(COPTS) $(INCLUDE) -fPIC -c -o $*.So $< + +all: $(TARGETS) + +$(TARGET): .depend $(OBJECTS) $(STATIC_LIBS) + rm -f ../lib/libsound.a + $(LINKER) -r -o $(TARGET) $(STATIC_LIBS) $(OBJECTS) + +$(STARGET): .depend $(SOBJECTS) $(DYNAMIC_LIBS) + rm -f ../lib/libsound*.so* + $(CC) -shared -Wl,-soname,libsound.so.$(SND_LIB_MAJOR) $(DYNAMIC_LIBS) $(SOBJECTS) -o $(STARGETX) + ln -s libsound.so.$(SND_LIB_VERSION) $(STARGET) + ln -s libsound.so.$(SND_LIB_VERSION) $(STARGETO) + +control/libcontrol.a: + $(MAKE) -C control +control/libcontrol.sa: + $(MAKE) -C control + +mixer/libmixer.a: + $(MAKE) -C mixer +mixer/libmixer.sa: + $(MAKE) -C mixer + +pcm/libpcm.a: + $(MAKE) -C pcm +pcm/libpcm.sa: + $(MAKE) -C pcm + +clean: + $(MAKE) -C control clean + $(MAKE) -C pcm clean + $(MAKE) -C mixer clean + rm -f core .depend *.o *.So *.orig *~ + rm -f ../lib/libsound.* + +.depend: + $(CPP) $(COPTS) $(INCLUDE) -M *.c > .depend + +# +# include a dependency file if one exists +# +ifeq (.depend,$(wildcard .depend)) +include .depend +endif diff --git a/src/control/Makefile b/src/control/Makefile new file mode 100644 index 00000000..38a47f15 --- /dev/null +++ b/src/control/Makefile @@ -0,0 +1,42 @@ +# +# Makefile for ALSA library +# Copyright (c) 1994-98 by Jaroslav Kysela <perex@jcu.cz> +# + +include ../../Makefile.conf + +TARGET=libcontrol.a +STARGET=libcontrol.Sa +OBJECTS=cards.o control.o +SOBJECTS=cards.So control.So +TARGETS=$(TARGET) $(STARGET) + +.SUFFIXES: +.SUFFIXES: .c .s .S .o .So .a .Sa + +.c.o: + $(CC) $(COPTS) $(INCLUDE) -c -o $*.o $< +.c.So: + $(CC) $(COPTS) $(INCLUDE) -fPIC -c -o $*.So $< + + +all: $(TARGETS) + +$(TARGET): .depend $(OBJECTS) + $(LINKER) -r -o $@ $(OBJECTS) + +$(STARGET): .depend $(SOBJECTS) + $(LINKER) -r -o $@ $(SOBJECTS) + +clean: + rm -f core .depend *.o *.So *.a *.Sa *.orig *~ + +.depend: + $(CPP) $(COPTS) $(INCLUDE) -M *.c > .depend + +# +# include a dependency file if one exists +# +ifeq (.depend,$(wildcard .depend)) +include .depend +endif diff --git a/src/control/cards.c b/src/control/cards.c new file mode 100644 index 00000000..413cb743 --- /dev/null +++ b/src/control/cards.c @@ -0,0 +1,94 @@ +/* + * Control Interface - main file + * Copyright (c) 1998 by Jaroslav Kysela <perex@jcu.cz> + * + * + * This library is free software; you can redistribute it and/or modify + * it under the terms of the GNU Library General Public License as + * published by the Free Software Foundation; either version 2 of + * the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ + +#include <stdio.h> +#include <stdlib.h> +#include <unistd.h> +#include <errno.h> +#include <ctype.h> +#include <fcntl.h> +#include <sys/ioctl.h> +#include "soundlib.h" + +#define SND_FILE_CONTROL "/dev/sndcontrol%i" + +int snd_cards( void ) +{ + int idx, count; + unsigned int mask; + + mask = snd_cards_mask(); + for ( idx = 0, count = 0; idx < SND_CARDS; idx++ ) { + if ( mask & (1 << idx) ) count++; + } + return count; +} + +/* + * this routine uses very ugly method... + * need to do... + */ + +unsigned int snd_cards_mask( void ) +{ + int fd, idx; + unsigned int mask; + char filename[32]; + + for ( idx = 0, mask = 0; idx < SND_CARDS; idx++ ) { + sprintf( filename, SND_FILE_CONTROL, idx ); + if ( (fd = open( filename, O_RDWR )) < 0 ) continue; + close( fd ); + mask |= 1 << idx; + } + return mask; +} + +int snd_card_name( const char *string ) +{ + int card, cards; + void *handle; + struct snd_ctl_hw_info info; + + cards = snd_cards(); + if ( cards <= 0 ) return -ENODEV; + if ( !string ) return -EINVAL; + if ( (isdigit( *string ) && *(string+1) == 0) || + (isdigit( *string ) && isdigit( *(string+1) ) && *(string+2) == 0) ) { + sscanf( string, "%i", &card ); + card--; + if ( card < 0 || card >= cards ) + return -EINVAL; + return card; + } + for ( card = 0; card < cards; card++ ) { + if ( snd_ctl_open( &handle, card ) < 0 ) + continue; + if ( snd_ctl_hw_info( handle, &info ) < 0 ) { + snd_ctl_close( handle ); + continue; + } + snd_ctl_close( handle ); + if ( !strcmp( info.id, string ) ) + return card; + } + return -ENODEV; +} diff --git a/src/control/control.c b/src/control/control.c new file mode 100644 index 00000000..6debff6b --- /dev/null +++ b/src/control/control.c @@ -0,0 +1,146 @@ +/* + * Control Interface - main file + * Copyright (c) 1998 by Jaroslav Kysela <perex@jcu.cz> + * + * + * This library is free software; you can redistribute it and/or modify + * it under the terms of the GNU Library General Public License as + * published by the Free Software Foundation; either version 2 of + * the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ + +#include <stdio.h> +#include <stdlib.h> +#include <unistd.h> +#include <errno.h> +#include <fcntl.h> +#include <sys/ioctl.h> +#include "soundlib.h" + +#define SND_FILE_CONTROL "/dev/sndcontrol%i" +#define SND_CTL_VERSION_MAX SND_PROTOCOL_VERSION( 1, 0, 0 ) + +typedef struct { + int card; + int fd; +} snd_ctl_t; + +int snd_ctl_open( void **handle, int card ) +{ + int fd, ver; + char filename[32]; + snd_ctl_t *ctl; + + *handle = NULL; + if ( card < 0 || card >= SND_CARDS ) return -EINVAL; + sprintf( filename, SND_FILE_CONTROL, card ); + if ( (fd = open( filename, O_RDWR )) < 0 ) return -errno; + if ( ioctl( fd, SND_CTL_IOCTL_PVERSION, &ver ) < 0 ) { + close( fd ); + return -errno; + } + if ( ver > SND_CTL_VERSION_MAX ) return -SND_ERROR_UNCOMPATIBLE_VERSION; + ctl = (snd_ctl_t *)calloc( 1, sizeof( snd_ctl_t ) ); + if ( ctl == NULL ) { + close( fd ); + return -ENOMEM; + } + ctl -> card = card; + ctl -> fd = fd; + *handle = ctl; + return 0; +} + +int snd_ctl_close( void *handle ) +{ + snd_ctl_t *ctl; + int res; + + ctl = (snd_ctl_t *)handle; + if ( !ctl ) return -EINVAL; + res = close( ctl -> fd ) < 0 ? -errno : 0; + free( ctl ); + return res; +} + +int snd_ctl_file_descriptor( void *handle ) +{ + snd_ctl_t *ctl; + + ctl = (snd_ctl_t *)handle; + if ( !ctl ) return -EINVAL; + return ctl -> fd; +} + +int snd_ctl_hw_info( void *handle, struct snd_ctl_hw_info *info ) +{ + snd_ctl_t *ctl; + + ctl = (snd_ctl_t *)handle; + if ( !ctl ) return -EINVAL; + if ( ioctl( ctl -> fd, SND_CTL_IOCTL_HW_INFO, info ) < 0 ) + return -errno; + return 0; +} + +int snd_ctl_pcm_info( void *handle, int dev, snd_pcm_info_t *info ) +{ + snd_ctl_t *ctl; + + ctl = (snd_ctl_t *)handle; + if ( !ctl ) return -EINVAL; + if ( ioctl( ctl -> fd, SND_CTL_IOCTL_PCM_DEVICE, &dev ) < 0 ) + return -errno; + if ( ioctl( ctl -> fd, SND_CTL_IOCTL_PCM_INFO, info ) < 0 ) + return -errno; + return 0; +} + +int snd_ctl_pcm_playback_info( void *handle, int dev, snd_pcm_playback_info_t *info ) +{ + snd_ctl_t *ctl; + + ctl = (snd_ctl_t *)handle; + if ( !ctl ) return -EINVAL; + if ( ioctl( ctl -> fd, SND_CTL_IOCTL_PCM_DEVICE, &dev ) < 0 ) + return -errno; + if ( ioctl( ctl -> fd, SND_CTL_IOCTL_PCM_PLAYBACK_INFO, info ) < 0 ) + return -errno; + return 0; +} + +int snd_ctl_pcm_record_info( void *handle, int dev, snd_pcm_record_info_t *info ) +{ + snd_ctl_t *ctl; + + ctl = (snd_ctl_t *)handle; + if ( !ctl ) return -EINVAL; + if ( ioctl( ctl -> fd, SND_CTL_IOCTL_PCM_DEVICE, &dev ) < 0 ) + return -errno; + if ( ioctl( ctl -> fd, SND_CTL_IOCTL_PCM_RECORD_INFO, info ) < 0 ) + return -errno; + return 0; +} + +int snd_ctl_mixer_info( void *handle, int dev, snd_mixer_info_t *info ) +{ + snd_ctl_t *ctl; + + ctl = (snd_ctl_t *)handle; + if ( !ctl ) return -EINVAL; + if ( ioctl( ctl -> fd, SND_CTL_IOCTL_MIXER_DEVICE, &dev ) < 0 ) + return -errno; + if ( ioctl( ctl -> fd, SND_CTL_IOCTL_MIXER_INFO, info ) < 0 ) + return -errno; + return 0; +} diff --git a/src/error.c b/src/error.c new file mode 100644 index 00000000..217a86d5 --- /dev/null +++ b/src/error.c @@ -0,0 +1,42 @@ +/* + * Error Routines + * Copyright (c) 1998 by Jaroslav Kysela <perex@jcu.cz> + * + * snd_strerror routine needs to be recoded for locale support + * + * + * This library is free software; you can redistribute it and/or modify + * it under the terms of the GNU Library General Public License as + * published by the Free Software Foundation; either version 2 of + * the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ + +#include <stdio.h> +#include <stdlib.h> +#include <string.h> +#include "soundlib.h" + +static const char *snd_error_codes[] = { + "Sound protocol isn't compatible" +}; + +const char *snd_strerror( int errnum ) +{ + if ( errnum < 0 ) errnum = -errnum; + if ( errnum < SND_ERROR_BEGIN ) + return (const char *)strerror( errnum ); + errnum -= SND_ERROR_BEGIN; + if ( errnum >= sizeof( snd_error_codes ) / sizeof( const char * ) ) + return "Unknown error"; + return snd_error_codes[ errnum ]; +} diff --git a/src/mixer/Makefile b/src/mixer/Makefile new file mode 100644 index 00000000..6d60adbf --- /dev/null +++ b/src/mixer/Makefile @@ -0,0 +1,41 @@ +# +# Makefile for ALSA library +# Copyright (c) 1994-98 by Jaroslav Kysela <perex@jcu.cz> +# + +include ../../Makefile.conf + +TARGET=libmixer.a +STARGET=libmixer.Sa +OBJECTS=mixer.o +SOBJECTS=mixer.So +TARGETS=$(TARGET) $(STARGET) + +.SUFFIXES: +.SUFFIXES: .c .s .S .o .So .a .Sa + +.c.o: + $(CC) $(COPTS) $(INCLUDE) -c -o $*.o $< +.c.So: + $(CC) $(COPTS) $(INCLUDE) -fPIC -c -o $*.So $< + +all: $(TARGETS) + +$(TARGET): .depend $(OBJECTS) + $(LINKER) -r -o $@ $(OBJECTS) + +$(STARGET): .depend $(SOBJECTS) + $(LINKER) -r -o $@ $(SOBJECTS) + +clean: + rm -f core .depend *.o *.So *.a *.Sa *.orig *~ + +.depend: + $(CPP) $(COPTS) $(INCLUDE) -M *.c > .depend + +# +# include a dependency file if one exists +# +ifeq (.depend,$(wildcard .depend)) +include .depend +endif diff --git a/src/mixer/mixer.c b/src/mixer/mixer.c new file mode 100644 index 00000000..3f973acc --- /dev/null +++ b/src/mixer/mixer.c @@ -0,0 +1,224 @@ +/* + * Mixer Interface - main file + * Copyright (c) 1998 by Jaroslav Kysela <perex@jcu.cz> + * + * + * This library is free software; you can redistribute it and/or modify + * it under the terms of the GNU Library General Public License as + * published by the Free Software Foundation; either version 2 of + * the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + * + */ + +#include <stdio.h> +#include <stdlib.h> +#include <unistd.h> +#include <string.h> +#include <errno.h> +#include <fcntl.h> +#include <sys/ioctl.h> +#include "soundlib.h" + +#define SND_FILE_MIXER "/dev/sndmixer%i%i" +#define SND_CTL_VERSION_MAX SND_PROTOCOL_VERSION( 1, 0, 0 ) + +typedef struct { + int card; + int device; + int fd; +} snd_mixer_t; + +int snd_mixer_open( void **handle, int card, int device ) +{ + int fd, ver; + char filename[32]; + snd_mixer_t *mixer; + + *handle = NULL; + if ( card < 0 || card >= SND_CARDS ) return -EINVAL; + sprintf( filename, SND_FILE_MIXER, card, device ); + if ( (fd = open( filename, O_RDWR )) < 0 ) return -errno; + if ( ioctl( fd, SND_MIXER_IOCTL_PVERSION, &ver ) < 0 ) { + close( fd ); + return -errno; + } + if ( ver > SND_CTL_VERSION_MAX ) return -SND_ERROR_UNCOMPATIBLE_VERSION; + mixer = (snd_mixer_t *)calloc( 1, sizeof( snd_mixer_t ) ); + if ( mixer == NULL ) { + close( fd ); + return -ENOMEM; + } + mixer -> card = card; + mixer -> device = device; + mixer -> fd = fd; + *handle = mixer; + return 0; +} + +int snd_mixer_close( void *handle ) +{ + snd_mixer_t *mixer; + int res; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + res = close( mixer -> fd ) < 0 ? -errno : 0; + free( mixer ); + return res; +} + +int snd_mixer_file_descriptor( void *handle ) +{ + snd_mixer_t *mixer; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + return mixer -> fd; +} + +int snd_mixer_channels( void *handle ) +{ + snd_mixer_t *mixer; + int result; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + if ( ioctl( mixer -> fd, SND_MIXER_IOCTL_CHANNELS, &result ) < 0 ) + return -errno; + return result; +} + +int snd_mixer_info( void *handle, snd_mixer_info_t *info ) +{ + snd_mixer_t *mixer; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + if ( ioctl( mixer -> fd, SND_MIXER_IOCTL_INFO, info ) < 0 ) + return -errno; + return 0; +} + +int snd_mixer_exact_mode( void *handle, int enable ) +{ + snd_mixer_t *mixer; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + if ( ioctl( mixer -> fd, SND_MIXER_IOCTL_EXACT, &enable ) < 0 ) + return -errno; + return 0; +} + +int snd_mixer_channel( void *handle, const char *channel_id ) +{ + snd_mixer_t *mixer; + snd_mixer_channel_info_t info; + int idx, channels, err; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + /* bellow implementation isn't optimized for speed */ + /* info about channels should be cached in the snd_mixer_t structure */ + if ( (channels = snd_mixer_channels( handle )) < 0 ) + return channels; + for ( idx = 0; idx < channels; idx++ ) { + if ( (err = snd_mixer_channel_info( handle, idx, &info )) < 0 ) + return err; + if ( !strncmp( channel_id, info.name, sizeof( info.name ) ) ) + return idx; + } + return -EINVAL; +} + +int snd_mixer_channel_info( void *handle, int channel, snd_mixer_channel_info_t *info ) +{ + snd_mixer_t *mixer; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + info -> channel = channel; + if ( ioctl( mixer -> fd, SND_MIXER_IOCTL_CHANNEL_INFO, info ) < 0 ) + return -errno; + return 0; +} + +int snd_mixer_channel_read( void *handle, int channel, snd_mixer_channel_t *data ) +{ + snd_mixer_t *mixer; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + data -> channel = channel; + if ( ioctl( mixer -> fd, SND_MIXER_IOCTL_CHANNEL_READ, data ) < 0 ) + return -errno; + return 0; +} + +int snd_mixer_channel_write( void *handle, int channel, snd_mixer_channel_t *data ) +{ + snd_mixer_t *mixer; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + data -> channel = channel; + if ( ioctl( mixer -> fd, SND_MIXER_IOCTL_CHANNEL_WRITE, data ) < 0 ) + return -errno; + return 0; +} + +int snd_mixer_special_read( void *handle, snd_mixer_special_t *special ) +{ + snd_mixer_t *mixer; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + if ( ioctl( mixer -> fd, SND_MIXER_IOCTL_SPECIAL_READ, special ) < 0 ) + return -errno; + return 0; +} + +int snd_mixer_special_write( void *handle, snd_mixer_special_t *special ) +{ + snd_mixer_t *mixer; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + if ( ioctl( mixer -> fd, SND_MIXER_IOCTL_SPECIAL_WRITE, special ) < 0 ) + return -errno; + return 0; +} + +int snd_mixer_read( void *handle, snd_mixer_callbacks_t *callbacks ) +{ + snd_mixer_t *mixer; + int idx, result, count; + unsigned int cmd, tmp; + unsigned char buffer[ 64 ]; + + mixer = (snd_mixer_t *)handle; + if ( !mixer ) return -EINVAL; + count = 0; + while ( (result = read( mixer -> fd, &buffer, sizeof( buffer ))) > 0 ) { + if ( result & 7 ) return -EIO; + if ( !callbacks ) continue; + for ( idx = 0; idx < result; idx += 8 ) { + cmd = *(unsigned int *)&buffer[ idx ]; + tmp = *(unsigned int *)&buffer[ idx + 4 ]; + if ( cmd == 0 && callbacks -> channel_was_changed ) { + callbacks -> channel_was_changed( callbacks -> private_data, (int)tmp ); + } + } + count += result >> 3; /* return only number of changes */ + } + return result >= 0 ? count : -errno; +} diff --git a/src/pcm/Makefile b/src/pcm/Makefile new file mode 100644 index 00000000..0825c683 --- /dev/null +++ b/src/pcm/Makefile @@ -0,0 +1,40 @@ +# +# Makefile for ALSA library +# Copyright (c) 1994-98 by Jaroslav Kysela <perex@jcu.cz> +# + +include ../../Makefile.conf + +TARGET=libpcm.a +STARGET=libpcm.Sa +OBJECTS=pcm.o +SOBJECTS=pcm.So +TARGETS=$(TARGET) $(STARGET) + +.SUFFIXES: .c .s .S .o .So .a .Sa + +.c.o: + $(CC) $(COPTS) $(INCLUDE) -c -o $*.o $< +.c.So: + $(CC) $(COPTS) $(INCLUDE) -fPIC -c -o $*.So $< + +all: $(TARGETS) + +$(TARGET): .depend $(OBJECTS) + $(LINKER) -r -o $@ $(OBJECTS) + +$(STARGET): .depend $(SOBJECTS) + $(LINKER) -r -o $@ $(SOBJECTS) + +clean: + rm -f core .depend *.o *.So *.a *.Sa *.orig *~ + +.depend: + $(CPP) $(COPTS) $(INCLUDE) -M *.c > .depend + +# +# include a dependency file if one exists +# +ifeq (.depend,$(wildcard .depend)) +include .depend +endif diff --git a/src/pcm/pcm.c b/src/pcm/pcm.c new file mode 100644 index 00000000..9687f7d1 --- /dev/null +++ b/src/pcm/pcm.c @@ -0,0 +1,265 @@ +/* + * PCM Interface - main file + * Copyright (c) 1998 by Jaroslav Kysela <perex@jcu.cz> + */ + +#include <stdio.h> +#include <stdlib.h> +#include <unistd.h> +#include <errno.h> +#include <fcntl.h> +#include <sys/ioctl.h> +#include "soundlib.h" + +#define SND_FILE_PCM "/dev/sndpcm%i%i" +#define SND_CTL_VERSION_MAX SND_PROTOCOL_VERSION( 1, 0, 0 ) + +typedef struct { + int card; + int device; + int fd; +} snd_pcm_t; + +int snd_pcm_open( void **handle, int card, int device, int mode ) +{ + int fd, ver; + char filename[32]; + snd_pcm_t *pcm; + + *handle = NULL; + if ( card < 0 || card >= SND_CARDS ) return -EINVAL; + sprintf( filename, SND_FILE_PCM, card, device ); + if ( (fd = open( filename, mode )) < 0 ) return -errno; + if ( ioctl( fd, SND_PCM_IOCTL_PVERSION, &ver ) < 0 ) { + close( fd ); + return -errno; + } + if ( ver > SND_CTL_VERSION_MAX ) return -SND_ERROR_UNCOMPATIBLE_VERSION; + pcm = (snd_pcm_t *)calloc( 1, sizeof( snd_pcm_t ) ); + if ( pcm == NULL ) { + close( fd ); + return -ENOMEM; + } + pcm -> card = card; + pcm -> device = device; + pcm -> fd = fd; + *handle = pcm; + return 0; +} + +int snd_pcm_close( void *handle ) +{ + snd_pcm_t *pcm; + int res; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + res = close( pcm -> fd ) < 0 ? -errno : 0; + free( pcm ); + return res; +} + +int snd_pcm_file_descriptor( void *handle ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + return pcm -> fd; +} + +int snd_pcm_block_mode( void *handle, int enable ) +{ + snd_pcm_t *pcm; + long flags; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( fcntl( pcm -> fd, F_GETFL, &flags ) < 0 ) + return -errno; + if ( enable ) + flags |= O_NONBLOCK; + else + flags &= ~O_NONBLOCK; + if ( fcntl( pcm -> fd, F_SETFL, &flags ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_info( void *handle, snd_pcm_info_t *info ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_INFO, info ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_playback_info( void *handle, snd_pcm_playback_info_t *info ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_PLAYBACK_INFO, info ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_record_info( void *handle, snd_pcm_record_info_t *info ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_RECORD_INFO, info ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_playback_format( void *handle, snd_pcm_format_t *format ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_PLAYBACK_FORMAT, format ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_record_format( void *handle, snd_pcm_format_t *format ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_RECORD_FORMAT, format ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_playback_params( void *handle, snd_pcm_playback_params_t *params ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_PLAYBACK_PARAMS, params ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_record_params( void *handle, snd_pcm_record_params_t *params ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_RECORD_PARAMS, params ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_playback_status( void *handle, snd_pcm_playback_status_t *status ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_PLAYBACK_STATUS, status ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_record_status( void *handle, snd_pcm_record_status_t *status ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_RECORD_STATUS, status ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_drain_playback( void *handle ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_DRAIN_PLAYBACK ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_flush_playback( void *handle ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_FLUSH_PLAYBACK ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_flush_record( void *handle ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_FLUSH_RECORD ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_playback_time( void *handle, int enable ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_PLAYBACK_TIME, &enable ) < 0 ) + return -errno; + return 0; +} + +int snd_pcm_record_time( void *handle, int enable ) +{ + snd_pcm_t *pcm; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + if ( ioctl( pcm -> fd, SND_PCM_IOCTL_RECORD_TIME, &enable ) < 0 ) + return -errno; + return 0; +} + +ssize_t snd_pcm_write( void *handle, const void *buffer, size_t size ) +{ + snd_pcm_t *pcm; + ssize_t result; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + result = write( pcm -> fd, buffer, size ); + if ( result < 0 ) return -errno; + return result; +} + +ssize_t snd_pcm_read( void *handle, void *buffer, size_t size ) +{ + snd_pcm_t *pcm; + ssize_t result; + + pcm = (snd_pcm_t *)handle; + if ( !pcm ) return -EINVAL; + result = read( pcm -> fd, buffer, size ); + if ( result < 0 ) return -errno; + return result; +} diff --git a/test/Makefile b/test/Makefile new file mode 100644 index 00000000..80a99a57 --- /dev/null +++ b/test/Makefile @@ -0,0 +1,15 @@ +CC = gcc +CFLAGS = -static -O2 -g -Wall -pipe +TARGETS = control mixer +LIB = -L../lib -lsound + +all: $(TARGETS) + +control: control.c + $(CC) $(CFLAGS) $(LIB) -o control control.c + +mixer: mixer.c + $(CC) $(CFLAGS) $(LIB) -o mixer mixer.c + +clean: + rm -f *.o $(TARGETS) *~ diff --git a/test/control.c b/test/control.c new file mode 100644 index 00000000..fa6e7502 --- /dev/null +++ b/test/control.c @@ -0,0 +1,67 @@ +#include <stdio.h> +#include <string.h> +#include "../include/soundlib.h" + +void main( void ) +{ + int idx, idx1, cards, err; + void *handle; + struct snd_ctl_hw_info info; + snd_pcm_info_t pcminfo; + snd_mixer_info_t mixerinfo; + char str[128]; + + cards = snd_cards(); + printf( "Detected %i soundcard%s...\n", cards, cards > 1 ? "s" : "" ); + if ( cards <= 0 ) { + printf( "Giving up...\n" ); + return; + } + for ( idx = 0; idx < cards; idx++ ) { + if ( (err = snd_ctl_open( &handle, idx )) < 0 ) { + printf( "Open error: %s\n", snd_strerror( err ) ); + continue; + } + if ( (err = snd_ctl_hw_info( handle, &info )) < 0 ) { + printf( "HW info error: %s\n", snd_strerror( err ) ); + continue; + } + printf( "Soundcard #%i:\n", idx + 1 ); + printf( " type - %i\n", info.type ); + printf( " gcaps - 0x%x\n", info.gcaps ); + printf( " lcaps - 0x%x\n", info.lcaps ); + printf( " pcm devs - 0x%x\n", info.pcmdevs ); + printf( " mixer devs - 0x%x\n", info.mixerdevs ); + printf( " midi devs - 0x%x\n", info.mididevs ); + memset( str, 0, sizeof( str ) ); + strncpy( str, info.id, sizeof( info.id ) ); + printf( " id - '%s'\n", str ); + printf( " abbreviation - '%s'\n", info.abbreviation ); + printf( " name - '%s'\n", info.name ); + printf( " longname - '%s'\n", info.longname ); + for ( idx1 = 0; idx1 < info.pcmdevs; idx1++ ) { + printf( "PCM info, device #%i:\n", idx1 ); + if ( (err = snd_ctl_pcm_info( handle, idx1, &pcminfo )) < 0 ) { + printf( " PCM info error: %s\n", snd_strerror( err ) ); + continue; + } + printf( " type - %i\n", pcminfo.type ); + printf( " flags - 0x%x\n", pcminfo.flags ); + printf( " id - '%s'\n", pcminfo.id ); + printf( " name - '%s'\n", pcminfo.name ); + } + for ( idx1 = 0; idx1 < info.mixerdevs; idx1++ ) { + printf( "MIXER info, device #%i:\n", idx1 ); + if ( (err = snd_ctl_mixer_info( handle, idx1, &mixerinfo )) < 0 ) { + printf( " MIXER info error: %s\n", snd_strerror( err ) ); + continue; + } + printf( " type - %i\n", mixerinfo.type ); + printf( " channels - %i\n", mixerinfo.channels ); + printf( " caps - 0x%x\n", mixerinfo.caps ); + printf( " id - '%s'\n", mixerinfo.id ); + printf( " name - '%s'\n", mixerinfo.name ); + } + snd_ctl_close( handle ); + } +} diff --git a/test/mixer.c b/test/mixer.c new file mode 100644 index 00000000..6ef0f30b --- /dev/null +++ b/test/mixer.c @@ -0,0 +1,60 @@ +#include <stdio.h> +#include <string.h> +#include "../include/soundlib.h" + +static void mixer_test( int card, int device ) +{ + int err, channels; + void *handle; + snd_mixer_info_t info; + + if ( (err = snd_mixer_open( &handle, card, device)) < 0 ) { + printf( "Mixer open error: %s\n", snd_strerror( err ) ); + return; + } + printf( "Mixer %i/%i open ok...\n", card, device ); + channels = snd_mixer_channels( handle ); + if ( channels < 0 ) { + printf( "Mixer channels error: %s\n", snd_strerror( channels ) ); + return; + } + printf( " Mixer have %i channel%s.\n", channels, channels > 1 ? "s" : "" ); + if ( (err = snd_mixer_info( handle, &info )) < 0 ) { + printf( "Mixer info error: %s\n", snd_strerror( err ) ); + return; + } + printf( " Info:\n" ); + printf( " type - %i\n", info.type ); + printf( " channels - %i\n", info.channels ); + printf( " caps - 0x%x\n", info.caps ); + printf( " id - '%s'\n", info.id ); + printf( " name - '%s'\n", info.name ); + snd_mixer_close( handle ); +} + +void main( void ) +{ + int idx, idx1, cards, err; + void *handle; + struct snd_ctl_hw_info info; + + cards = snd_cards(); + printf( "Detected %i soundcard%s...\n", cards, cards > 1 ? "s" : "" ); + if ( cards <= 0 ) { + printf( "Giving up...\n" ); + return; + } + for ( idx = 0; idx < cards; idx++ ) { + if ( (err = snd_ctl_open( &handle, idx )) < 0 ) { + printf( "Open error: %s\n", snd_strerror( err ) ); + continue; + } + if ( (err = snd_ctl_hw_info( handle, &info )) < 0 ) { + printf( "HW info error: %s\n", snd_strerror( err ) ); + continue; + } + for ( idx1 = 0; idx1 < info.mixerdevs; idx1++ ) + mixer_test( idx, idx1 ); + snd_ctl_close( handle ); + } +} diff --git a/utils/Makefile b/utils/Makefile new file mode 100644 index 00000000..d9e97658 --- /dev/null +++ b/utils/Makefile @@ -0,0 +1,10 @@ +# +# Makefile for ALSA library +# Copyright (c) 1994-98 by Jaroslav Kysela <perex@jcu.cz> +# + +include ../Makefile.conf + +clean: + rm -f core .depend *.o *.orig *~ + diff --git a/utils/alsa-lib.spec b/utils/alsa-lib.spec new file mode 100644 index 00000000..80a73f59 --- /dev/null +++ b/utils/alsa-lib.spec @@ -0,0 +1,77 @@ +%define ver 0.0.9 +%define rel 1 +%define prefix / + +Summary: Advanced Linux Sound Architecture (ALSA) - Library +Name: alsa-lib +Version: %ver +Release: %rel +Copyright: GPL +Group: System/Libraries +Source: ftp://alsa.jcu.cz/pub/lib/alsa-lib-%{ver}.tar.gz +BuildRoot: /tmp/alsa-lib-%{ver} +Packager: Helge Jensen <slog@slog.dk> +URL: http://alsa.jcu.cz +Docdir: %{prefix}/usr/doc + +%description + +Advanced Linux Sound Architecture (ALSA) - Library + +Features +======== + +* general + - modularized architecture with support for 2.0 and latest 2.1 kernels + - support for versioned and exported symbols + - full proc filesystem support - /proc/sound +* ISA soundcards + - support for 128k ISA DMA buffer +* mixer + - new enhanced API for applications + - support for unlimited number of channels + - volume can be set in three ways (percentual (0-100), exact and decibel) + - support for mute (and hardware mute if hardware supports it) + - support for mixer events + - this allows two or more applications to be synchronized +* digital audio (PCM) + - new enhanced API for applications + - full real duplex support + - full duplex support for SoundBlaster 16/AWE soundcards + - digital audio data for playback and record should be read back using + proc filesystem +* OSS/Lite compatibility + - full mixer compatibity + - full PCM (/dev/dsp) compatibility + +%changelog + +* Mon May 28 1998 Helge Jensen <slog@slog.dk> + +- Made SPEC file + +%prep +%setup -n alsa-lib +%build + +./configure --prefix=/usr +make + +%install +mkdir -p $RPM_BUILD_ROOT/usr/include/sys +mkdir -p $RPM_BUILD_ROOT/usr/lib + +make prefix="$RPM_BUILD_ROOT/usr" install + +%clean +rm -rf $RPM_BUILD_ROOT + +%files +%defattr(-, root, root) + +%doc doc/*.html +%doc doc/*.sgml +%doc doc/*.txt + +%{prefix}/usr/include/sys/soundlib.h +%{prefix}/usr/lib/lib* diff --git a/utils/alsa-lib.spec.in b/utils/alsa-lib.spec.in new file mode 100644 index 00000000..8ff7f66e --- /dev/null +++ b/utils/alsa-lib.spec.in @@ -0,0 +1,78 @@ +%define ver @SND_LIB_VERSION@ +%define rel 1 +%define prefix / + +Summary: Advanced Linux Sound Architecture (ALSA) - Library +Name: alsa-lib +Version: %ver +Release: %rel +Copyright: GPL +Group: System/Libraries +Source: ftp://alsa.jcu.cz/pub/lib/alsa-lib-%{ver}.tar.gz +BuildRoot: /tmp/alsa-lib-%{ver} +Packager: Helge Jensen <slog@slog.dk> +URL: http://alsa.jcu.cz +Docdir: %{prefix}/usr/doc +Requires: alsa-driver + +%description + +Advanced Linux Sound Architecture (ALSA) - Library + +Features +======== + +* general + - modularized architecture with support for 2.0 and latest 2.1 kernels + - support for versioned and exported symbols + - full proc filesystem support - /proc/sound +* ISA soundcards + - support for 128k ISA DMA buffer +* mixer + - new enhanced API for applications + - support for unlimited number of channels + - volume can be set in three ways (percentual (0-100), exact and decibel) + - support for mute (and hardware mute if hardware supports it) + - support for mixer events + - this allows two or more applications to be synchronized +* digital audio (PCM) + - new enhanced API for applications + - full real duplex support + - full duplex support for SoundBlaster 16/AWE soundcards + - digital audio data for playback and record should be read back using + proc filesystem +* OSS/Lite compatibility + - full mixer compatibity + - full PCM (/dev/dsp) compatibility + +%changelog + +* Mon May 28 1998 Helge Jensen <slog@slog.dk> + +- Made SPEC file + +%prep +%setup -n alsa-lib +%build + +./configure --prefix=/usr +make + +%install +mkdir -p $RPM_BUILD_ROOT/usr/include/sys +mkdir -p $RPM_BUILD_ROOT/usr/lib + +make prefix="$RPM_BUILD_ROOT/usr" install + +%clean +rm -rf $RPM_BUILD_ROOT + +%files +%defattr(-, root, root) + +%doc doc/*.html +%doc doc/*.sgml +%doc doc/*.txt + +%{prefix}/usr/include/sys/soundlib.h +%{prefix}/usr/lib/lib* diff --git a/utils/buildrpm b/utils/buildrpm new file mode 100644 index 00000000..36230e22 --- /dev/null +++ b/utils/buildrpm @@ -0,0 +1,35 @@ +#!/bin/bash + +source=. +version=`cat $source/../version` +package=$source/../../alsa-lib-$version.tar.gz + +if [ ! -r $package ]; then + echo "Error: wrong package: $package" + exit 1 +fi + +make -C .. pack + +cp -fv $package /usr/src/redhat/SOURCES + +if [ ! -r $source/buildrpm ]; then + echo "Error: invalid directory: $source" + exit 1 +fi + +if [ ! -d /usr/src/redhat ]; then + echo "Error: /usr/src/redhat directory not found" + exit 1 +fi + +if [ ! -r $source/alsa-lib.spec ]; then + cd $source/.. + ./configure + cd utils +fi + +cp -fv $source/alsa-lib.spec /usr/src/redhat/SPECS +cd /usr/src/redhat/SPECS +rpm -ba alsa-lib.spec +cd /usr/src/redhat diff --git a/version b/version new file mode 100644 index 00000000..c5d54ec3 --- /dev/null +++ b/version @@ -0,0 +1 @@ +0.0.9 -- 2.47.1