rndc-confgen.html revision 8a66318e41ed14c5a88130e8c362610e8faa2121
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
c78c39caab4cf8b5daefc9c65878f7f5ed3eb7a0Tinderbox User - Copyright (C) 2001-2003 Internet Software Consortium.
ab496cc3df1648e9ad992a87c35c2c0870fdc69dTinderbox User - Permission to use, copy, modify, and distribute this software for any
7c1468ed500356839a4a222517364e6ce18cb1a2Tinderbox User - purpose with or without fee is hereby granted, provided that the above
c57668a2fbbe558c1bd21652813616f2f517c469Tinderbox User - copyright notice and this permission notice appear in all copies.
1f4c645185bd8fc70048e0a69eee46193a284e5cTinderbox User - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
8de3f14f1c300c3e1ed99084cc03485b42c92bf1Tinderbox User - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
950d203b64f512b85fcc093ee1e9e3e531a1aea3Tinderbox User - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews - PERFORMANCE OF THIS SOFTWARE.
a7c412f37cc73d0332887a746e81220cbf09dd00Mark Andrews<!-- $Id: rndc-confgen.html,v 1.8 2004/03/05 08:32:17 marka Exp $ -->
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews>rndc-confgen</TITLE
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserNAME="GENERATOR"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCONTENT="Modular DocBook HTML Stylesheet Version 1.73
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="REFENTRY"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsBGCOLOR="#FFFFFF"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserTEXT="#000000"
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark AndrewsLINK="#0000FF"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsVLINK="#840084"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserALINK="#0000FF"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="APPLICATION"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User>rndc-confgen</SPAN
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan HuntCLASS="REFNAMEDIV"
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan HuntCLASS="APPLICATION"
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User>rndc-confgen</SPAN
0e573cdd111e060e5f6c18249b5ccacbe8abe278Tinderbox User> -- rndc key generation tool</DIV
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="REFSYNOPSISDIV"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="COMMAND"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>rndc-confgen</B
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="OPTION"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="OPTION"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="REPLACEABLE"
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox UserCLASS="OPTION"
2ae159b376dac23870d8005563c585acf85a4b5aEvan HuntCLASS="REPLACEABLE"
2ae159b376dac23870d8005563c585acf85a4b5aEvan HuntCLASS="OPTION"
2ae159b376dac23870d8005563c585acf85a4b5aEvan HuntCLASS="OPTION"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="REPLACEABLE"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="OPTION"
0e573cdd111e060e5f6c18249b5ccacbe8abe278Tinderbox UserCLASS="REPLACEABLE"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="OPTION"
91216cff91b34c9ff6e846dc23f248219cafe660Andreas GustafssonCLASS="REPLACEABLE"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>randomfile</I
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark AndrewsCLASS="OPTION"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="REPLACEABLE"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="OPTION"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="REPLACEABLE"
28a5dd720187fddb16055a0f64b63a7b66f29f64Mark AndrewsCLASS="OPTION"
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsCLASS="REPLACEABLE"
2a31bd531072824ef252c18303859d6af7451b00Francis DupontCLASS="REFSECT1"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>DESCRIPTION</H2
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsCLASS="COMMAND"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>rndc-confgen</B
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews> generates configuration files
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsCLASS="COMMAND"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>. It can be used as a
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews convenient alternative to writing the
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserCLASS="FILENAME"
e20788e1216ed720aefa84f3295f7899d9f28c22Mark Andrews and the corresponding <B
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="COMMAND"
37d8e0a4455876fe1e4cca511076cc2c5ab9eedeTinderbox UserCLASS="COMMAND"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews statements in <TT
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="FILENAME"
fe80a4909bf62b602feaf246866e9d29f7654194Automatic Updater Alternatively, it can be run with the <B
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="COMMAND"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews option to set up a <TT
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="FILENAME"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews avoid the need for a <TT
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="FILENAME"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="COMMAND"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User> statement altogether.
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="REFSECT1"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="VARIABLELIST"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> Do automatic <B
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="COMMAND"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User> configuration.
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews This creates a file <TT
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="FILENAME"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="FILENAME"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User> (or whatever
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox UserCLASS="VARNAME"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>sysconfdir</TT
a7c412f37cc73d0332887a746e81220cbf09dd00Mark Andrews was specified as when <SPAN
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserCLASS="ACRONYM"
933799f3641f4f78445d015008bad0038900a82aTinderbox User that is read by both <B
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserCLASS="COMMAND"
8711e5c73ca872d59810760af0332194cbdd619bAutomatic UpdaterCLASS="COMMAND"
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews> on startup. The
933799f3641f4f78445d015008bad0038900a82aTinderbox UserCLASS="FILENAME"
933799f3641f4f78445d015008bad0038900a82aTinderbox User> file defines a default
4151211e6649332f7b5a55870cbe37128bcc7b29Tinderbox User command channel and authentication key allowing
bc0a53583d92309bebcf93c408e2f3247ebd3d3cAutomatic UpdaterCLASS="COMMAND"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater> to communicate with
b02be031b9ff37b042adc8e68e36b8bbc1f672b7Tinderbox UserCLASS="COMMAND"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> on the local host
59528addd704f8d5757b54e540520f74e588a7c7Automatic Updater with no further configuration.
933799f3641f4f78445d015008bad0038900a82aTinderbox UserCLASS="COMMAND"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater>rndc-confgen -a</B
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic UpdaterCLASS="COMMAND"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater> to be used as drop-in
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater replacements for BIND 8 and <B
5ecad47f69b3fd945472ab2900a9ff826a7ce2f6Automatic UpdaterCLASS="COMMAND"
c2abd6efeb9affa70aabb63da2acb23e135cf7f2Mark Andrews with no changes to the existing BIND 8
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserCLASS="FILENAME"
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User> If a more elaborate configuration than that
4cda4fd158d6ded5586bacea8c388445d99611eaAutomatic Updater generated by <B
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="COMMAND"
b02be031b9ff37b042adc8e68e36b8bbc1f672b7Tinderbox User>rndc-confgen -a</B
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews is required, for example if rndc is to be used remotely,
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater you should run <B
4fe0411487e8e4401477684c0a2bac041ca7c2d5Tinderbox UserCLASS="COMMAND"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews>rndc-confgen</B
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews> without the
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="COMMAND"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews> option and set up a
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserCLASS="FILENAME"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="FILENAME"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="REPLACEABLE"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> Specifies the size of the authentication key in bits.
757ff043760e4743dda1a10e7d58349275934902Tinderbox User Must be between 1 and 512 bits; the default is 128.
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="REPLACEABLE"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User> Used with the <B
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="COMMAND"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> option to specify
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox User an alternate location for <TT
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="FILENAME"
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews> Prints a short summary of the options and arguments to
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="COMMAND"
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews>rndc-confgen</B
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="REPLACEABLE"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews> Specifies the key name of the rndc authentication key.
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews This must be a valid domain name.
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews The default is <TT
e8fc8c884b44371784805e1e0d3100da403dd3f1Automatic UpdaterCLASS="CONSTANT"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>rndc-key</TT
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="REPLACEABLE"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews> Specifies the command channel port where <B
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="COMMAND"
39cad8fb7d7ff3436bb24ce761354afcb80d295aMark Andrews listens for connections from <B
c5a97a549c89d562e999d4f906b882c5a2a474e1Tinderbox UserCLASS="COMMAND"
95c3a5e116c1da135f669c3f15398172fac6279dMark Andrews The default is 953.
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox UserCLASS="REPLACEABLE"
0e573cdd111e060e5f6c18249b5ccacbe8abe278Tinderbox User> Specifies a source of random data for generating the
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews authorization. If the operating
933799f3641f4f78445d015008bad0038900a82aTinderbox User system does not provide a <TT
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="FILENAME"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews or equivalent device, the default source of randomness
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson is keyboard input. <TT
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="FILENAME"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>randomdev</TT
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews the name of a character device or file containing random
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews data to be used instead of the default. The special value
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="FILENAME"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>keyboard</TT
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> indicates that keyboard
3a988722ad9e209ba4064604d482dc4efe0e19ebTinderbox User input should be used.
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="REPLACEABLE"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> Specifies the IP address where <B
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="COMMAND"
a5636b773fa05a272b6876afd99309c0b3090e2fMark Andrews listens for command channel connections from
a5636b773fa05a272b6876afd99309c0b3090e2fMark AndrewsCLASS="COMMAND"
a5636b773fa05a272b6876afd99309c0b3090e2fMark Andrews>. The default is the loopback
f7369b2881b5e63d69600adcedc8ba938303d30cTinderbox User address 127.0.0.1.
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="REPLACEABLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> Used with the <B
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="COMMAND"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> option to specify
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington a directory where <B
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="COMMAND"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington chrooted. An additional copy of the <TT
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="FILENAME"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington will be written relative to this directory so that
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington it will be found by the chrooted <B
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="COMMAND"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="REPLACEABLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> Used with the <B
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="COMMAND"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> option to set the owner
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="FILENAME"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> file generated. If
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="COMMAND"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> is also specified only the file in
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington the chroot area has its owner changed.
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="REFSECT1"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsNAME="AEN147"
ae7e54b14c946e0984c191554db9abb4893f9349Automatic UpdaterCLASS="COMMAND"
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox User> to be used with
ae7e54b14c946e0984c191554db9abb4893f9349Automatic Updater no manual configuration, run
ae7e54b14c946e0984c191554db9abb4893f9349Automatic UpdaterCLASS="USERINPUT"
ae7e54b14c946e0984c191554db9abb4893f9349Automatic Updater>rndc-confgen -a</B
c11c7b47726c02eb05e29ff7be56a3343146e396Tinderbox User> To print a sample <TT
c11c7b47726c02eb05e29ff7be56a3343146e396Tinderbox UserCLASS="FILENAME"
c11c7b47726c02eb05e29ff7be56a3343146e396Tinderbox User corresponding <B
c11c7b47726c02eb05e29ff7be56a3343146e396Tinderbox UserCLASS="COMMAND"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="COMMAND"
0accdb26ead1fe520a9820b52efbea64bdf564e3Tinderbox User statements to be manually inserted into <TT
c11c7b47726c02eb05e29ff7be56a3343146e396Tinderbox UserCLASS="FILENAME"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="USERINPUT"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>rndc-confgen</B
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="REFSECT1"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>SEE ALSO</H2
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="CITEREFENTRY"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="REFENTRYTITLE"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="CITEREFENTRY"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="REFENTRYTITLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="CITEREFENTRY"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="REFENTRYTITLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="CITETITLE"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington>BIND 9 Administrator Reference Manual</I
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian WellingtonCLASS="REFSECT1"
9e3a7b0faf417a10f5f689edf288807b2d5eedc5Brian Wellington> Internet Software Consortium