# This is a shell archive.  Save it in a file, remove anything before
# this line, and then unpack it by entering "sh file".  Note, it may
# create directories; files and directories will be owned by you and
# have default permissions.
#
# This archive contains:
#
#       Makefile
#       kiconv_cs_preload.8
#       kiconv_cs_preload.c
#       loadfscharsets
#
echo x - Makefile
sed 's/^X//' >Makefile << 'END-of-Makefile'
X#      @(#)Makefile    8.3 (Berkeley) 3/27/94
X# $$
X
XPROG=  kiconv_cs_preload
XSRCS=  kiconv_cs_preload.c
XMAN=   kiconv_cs_preload.8
XDPADD= ${LIBKICONV}
XLDADD= -lkiconv
XBINDIR=        /usr/sbin
X
XWARNS?=        0
X
X# Needs to be dynamically linked for optional dlopen() access to
X# userland libiconv
XNO_SHARED?=    NO
X
X.include <bsd.prog.mk>
END-of-Makefile
echo x - kiconv_cs_preload.8
sed 's/^X//' >kiconv_cs_preload.8 << 'END-of-kiconv_cs_preload.8'
X.Dd February 19, 2006
X.Dt kiconv_cs_preload 8
X.Os
X.Sh NAME
X.Nm kiconv_cs_preload
X.Nd load kernel charset conversion tables
X.Sh SYNOPSIS
X.Nm
X.Ar locchrset Ns Op : Ns Ar dskcharset
X[
X.Ar locchrset Ns Op : Ns Ar dskcharset
X]...
X.Sh DESCRIPTION
XThe
X.Nm
Xloads specified character conversion tables into kernel for futher
Xusage with -C options of
X.Xr mount_cd9660 8 ,
X.Xr mount_udf 8 ,
X.Xr mount_ntfs 8
Xand
X-C and -D options of
X.Xr mount_msdosfs 8 .
X.Pp
XWhen sysctl vfs.usermount==1 non-root user is not capable to use -C option of
Xmount_* until root loads convertion table using -C option of mount_* or
X.Nm .
X.Pp
XOperands:
X.Pp
X.Bl -tag
X.It Ar locchrset
XCharset used by users, i.e. UTF-8, ISO8859-1, etc.
X.It Ar dskcharset
XCharset used for filenames on filesystem. Default is UTF-16BE,
Xcharset for CD9660 with Joliet extention, UDF and NTFS filesystems.
X.El
X.Sh EXAMPLES
XTo allow russian KDE users to view cyrillic symbols on Joliet CD:
X.Pp
X.Dl "root# kldload cd9660_iconv"
X.Dl "root# kiconv_cs_preload UTF-8"
X.Dl "user$ mount -t cd9660 -C UTF-8 /dev/acd0 /cdrom"
X.Pp
XTo allow those users to correctly work with MS-DOS diskettes and Joliet CD:
X.Pp
X.Dl "root# kldload msdosfs_iconv"
X.Dl "root# kiconv_cs_preload UTF-8 UTF-8:CP866"
X.Dl "user$ mount_msdosfs -DCP866 -Lru_RU.UTF-8 /dev/fd0 /mnt"
X.Pp
XKeep in mind that user should have read-write access to devices
X(/dev/acd0,/dev/fd0, etc) and mountpoints (/mnt, /cdrom, etc), and
X.Ar vfs.usermount
Xsysctl should be 1 (see
X.Xr mount 2 Ns ).
X.Sh SEE ALSO
X.Xr iconv 3 ,
X.Xr kiconv_add_xlat16_cspairs 3 ,
X.Xr mount 2 .
X.Sh HISTORY
XThe
X.Nm
Xutility appeared in
X.Fx 6.0 .
END-of-kiconv_cs_preload.8
echo x - kiconv_cs_preload.c
sed 's/^X//' >kiconv_cs_preload.c << 'END-of-kiconv_cs_preload.c'
X#include <err.h>
X#include <errno.h>
X#include <stdio.h>
X#include <string.h>
X#include <sysexits.h>
X#include <sys/types.h>
X#include <sys/iconv.h>
X
Xvoid usage(const char*);
X
Xint main(int argc, char* argv[]) {
X    int exCode = 0;
X
X    if( argc < 2 ) usage(argv[0]);
X
X    while(--argc) {
X       char* disk  = ENCODING_UNICODE;
X       char* local = *++argv;
X       char* colon = strchr(local,':');
X       if( colon ) {
X           disk = colon + 1;
X           *colon = '\0';
X       }
X
X       if( strlen(disk) >= ICONV_CSNMAXLEN ) {
X           warnx("Too long charset name: %s", disk);
X           continue;
X       }
X
X       if( strlen(local)   >= ICONV_CSNMAXLEN ) {
X           warnx("Too long charset name: %s", local);
X           continue;
X       }
X
X       warnx(
X           "Preloading converstion tables between \"%s\" and \"%s\" charsets.",
X           disk,local
X       );
X       if( kiconv_add_xlat16_cspairs(disk,local) ) {
X           warn("kiconv");
X           exCode = 1;
X       }
X    }
X    return exCode;
X}
X
Xvoid usage(const char* n) {
X    fprintf(
X       stderr,
X       "usage: %s local_charset[:disk_charset] [local_charset[:disk_charset]...]\n"
X       "\n"
X       "Options:\n"
X       "  local_charset - local charset (UTF-8, ISO8859-1 et al),\n"
X       "  disk_charset  - code page used for filenames on devices, default UTF-16BE.\n"
X       "\n"
X       "The UTF-16BE charset is used for filenames on CD9660, UDF and "
X       "NTFS filesystems.\n",
X       n
X    );
X    exit(0);
X}
END-of-kiconv_cs_preload.c
echo x - loadfscharsets
sed 's/^X//' >loadfscharsets << 'END-of-loadfscharsets'
X#!/bin/sh
X
X# PROVIDE: loadfscharsets
X# REQUIRE: DAEMON
X# BEFORE:  LOGIN
X
X. /etc/rc.subr
X
Xname=loadfscharsets
Xrcvar=`set_rcvar`
X
Xload_rc_config $name
X
Xstop_cmd=":"
Xstart_precmd=loadfscharsets_precmd
X
Xcommand=/usr/sbin/kiconv_cs_preload
X
Xcommand_args=""
Xfor cspair in ${loadfscharsets_cspairs}; do
X    case "$cspair" in
X    [rR][uU][sS][sS][iI][aA][nN] | ru_RU.UTF-8 )
X       command_args="$command_args UTF-8 UTF-8:CP866"
X       ;;
X    [jJ][aA][pP][aA][nN][eE][sS][eE] | ja_JP:UTF-8 )
X       command_args="$command_args UTF-8 UTF-8:CP932"
X       ;;
X    ru_RU.KOI8-R )
X       command_args="$command_args KOI8-R KOI8-R:CP866"
X       ;;
X    ja_JP.eucJP )
X       command_args="$command_args eucJP eucJP:CP932"
X       ;;
X    * )
X       command_args="$command_args $cspair"
X       ;;
X    esac
Xdone
X
X: ${loadfscharsets_fstypes:=cd9660 msdosfs udf}
X
Xloadfscharsets_precmd() {
X    for fst in ${loadfscharsets_fstypes}; do
X       kldstat -q -m ${fst}_iconv || {
X           info "Loading media charset conversion module for $fst filesystems"
X           kldload ${fst}_iconv || return 1
X       }
X    done
X    [ -z "$command_args" ] &&
X       err 1 "\$loadfscharsets_cspairs is not set properly"
X    return 0
X}
X
Xrun_rc_command "$1"
END-of-loadfscharsets
exit