1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-24 11:29:10 +00:00

More style fixes, both to code and man page.

Submitted by:	Philippe Charnier <charnier@xp11.frmug.org>
This commit is contained in:
Boris Popov 2000-01-15 09:06:37 +00:00
parent 3e2d3e2621
commit 3d2afd8604
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=56036
4 changed files with 138 additions and 120 deletions

View File

@ -8,10 +8,10 @@
.Sh SYNOPSIS
.Nm mount_nwfs
.Op Fl Chv
.Ar -S Ar server
.Ar -U Ar user
.Ar "[connection options]"
.Ar -V Ar volume
.Fl S Ar server
.Fl U Ar user
.Op Fl connection\ options
.Fl V Ar volume
.Op Fl M Ar mode
.Op Fl c Ar case
.Op Fl d Ar mode
@ -24,12 +24,12 @@
.Ar node
.Nm mount_nwfs
.Op Fl options
.Ar /server:user/volume/path
.Ar /server:user/volume[/path]
.Ar node
.Sh DESCRIPTION
The
.Nm
command allow to mount volume from a NetWare server. It may use either
command allows to mount volume from a NetWare server. It may use either
existing connection or create new: if no usable connection was found
it will try to establish a new one. Connection has count of references to it,
so when last mount will be dismounted connection will be closed. It is
@ -50,16 +50,20 @@ command line arguments (the
.Fl U
and
.Fl V
options aren't used in this case). This allows use of fstab file (see EXAMPLES below).
options aren't used in this case). This allows use of
.Xr fstab 5
file (see
.Sx EXAMPLES
below).
.Pp
The options are:
.Bl -tag -width indent
.It Fl S Ar server
name of NetWare server to connect. For native IP you will need also
Name of NetWare server to connect. For native IP you will need also
.Fl A
option.
.It Fl U Ar user
name of user used in login sequence.
Name of user used in login sequence.
.It Fl "[connection options]"
See
.Xr ncplogin 1
@ -71,7 +75,7 @@ before
.It Ar node
Path to mount volume.
.It Fl c Ar case
Selects a
Select a
.Ar case
option which affects on name representation.
.Ar Case
@ -96,46 +100,49 @@ u All existing file names converted to upper case.
U Same as 'u' but file system tries to be case
insensitive. May not work well.
.Ed
.It Fl f Ar mode, Fl d Ar mode
specifies permissions that should be assigned to files and directories.
.It Fl f Ar mode , Fl d Ar mode
Specify permissions that should be assigned to files and directories.
The values must be specified as octal numbers. Default value for the file mode
taken from mount point, default value for the dir mode adds execute permission
where the file mode gives read permission.
is taken from mount point, default value for the dir mode adds execute
permission where the file mode gives read permission.
Note that these permissions can differ from the rights granted by NetWare
server.
.It Fl n Ar namespace
don't use
Don't use
.Ar namespace .
Currently only
.Ar OS2
can be here.
.It Fl v
prints version number.
.It Fl u Ar uid, Fl g Ar gid
Print version number.
.It Fl u Ar uid , Fl g Ar gid
User id and group id assigned to files. The default is owner and group id from
directory where volume is mounted.
.It Fl l Ar locale
Sets the locale for case conversion. By default
Set the locale for case conversion. By default
.Nm
tries to use an environment variable
.Ar LC_* .
.Ev LC_* .
.It Fl w Ar scheme
Selects a
Select a
.Ar scheme
used to convert file names between NetWare and FreeBSD. Currently only
used to convert file names between NetWare and
.Bx Free .
Currently only
.Ar koi2cp866
and
.Ar asis
can be here. Please note, that scheme should be enabled at compile
time in config.mk file.
time in
.Pa config.mk
file.
.It Fl M Ar mode
See
.Xr ncplogin 1
for details. If this option is omitted, connection permissions
assumed the same as directory mode (
.Ar -d )
option.
assumed the same as directory mode
.Pf ( Fl d Ns ) option.
.El
.Sh FILES
.Bl -tag -width /var/log/wtmp -compact
@ -143,19 +150,19 @@ option.
keeps static parameters for connections and other information. See
.Pa /usr/share/examples/nwclient/dot.nwfsrc
for details.
.El
.Sh NOTES
Before any NCP connection can be established kernel must be configured
for IPX support, IPXrouted and KLD nwfs.ko should be loaded.
.Sh EXAMPLES
Next examples illustrates how to connect to NetWare server
.Ar nwserv
.Em nwserv
as user
.Ar GUEST
.Em GUEST
and mount volumes
.Ar SYS
.Em SYS
and
.Ar VOL1 :
.Em VOL1 :
.Bd -literal -offset indent
mount_nwfs -S nwserv -U guest -V sys /nw/s1/sys
mount_nwfs /nwserv:guest/sys /nw/s1/sys
@ -166,7 +173,9 @@ mount -t nwfs /nwserv:boris/sys/home/boris /home/boris/nw/home
The last example mounts only subdirectory on a volume and equivalent
to NetWare 'map root' command.
.Pp
It is possible to use fstab for nwfs mounts:
It is possible to use
.Xr fstab 5
for nwfs mounts:
.Bd -literal -offset indent
/nwserv:guest/sys /nw/s1/sys nwfs rw,noauto 0 0
/nwserv:guest/vol1 /nw/s1/vol2 nwfs rw,noauto 0 0
@ -176,17 +185,23 @@ It is possible to use fstab for nwfs mounts:
to number a few
.Sh CREDITS
In development of NetWare client for FreeBSD, the following sources were used:
In development of NetWare client for
.Bx Free ,
the following sources were used:
.Pp
Documentation from NetWare NDK.
.Pp
ncpfs for Linux - written by Volker Lendecke (lendecke@math.uni-goettingen.de).
Ncpfs for Linux - written by
.An Volker Lendecke Aq lendecke@math.uni-goettingen.de .
He granted me permission to publish parts of his code under BSD-style license,
.Pp
"Interrupt List" from Ralf Brown,
"Interrupt List" from
.An Ralf Brown ,
.Pp
Many files from /sys directory.
Many files from
.Pa /sys
directory.
.Sh AUTHOR
.Sh AUTHORS
.An Boris Popov Aq bp@butya.kz ,
.Aq rbp@chat.ru

View File

@ -53,7 +53,6 @@
#define NWFS_VFSNAME "nwfs"
extern char *__progname;
static char mount_point[MAXPATHLEN + 1];
static void usage(void);
static int parsercfile(struct ncp_conn_loginfo *li, struct nwfs_args *mdata);
@ -134,7 +133,7 @@ main(int argc, char *argv[]) {
while (*p != '/' && *p != 0) *p1++ = *p++;
*p1 = 0;
if (strlen(tmp) > NCP_VOLNAME_LEN) {
warnx("volume name too long: %s\n", tmp);
warnx("volume name too long: %s", tmp);
break;
}
ncp_str_upper(strcpy(mdata.mounted_vol,tmp));
@ -160,7 +159,7 @@ main(int argc, char *argv[]) {
} while(0);
if (error)
errx(EX_DATAERR,
"an error occured while parsing '%s'",
"an error occurred while parsing '%s'",
argv[argc - 2]);
}
if (ncp_li_readrc(&li)) return 1;
@ -168,7 +167,7 @@ main(int argc, char *argv[]) {
parsercfile(&li,&mdata);
rc_close(ncp_rc);
}
while ((opt = getopt(argc, argv, STDPARAM_OPT"V:c:d:f:g:l:n:o:u:w:")) != EOF) {
while ((opt = getopt(argc, argv, STDPARAM_OPT"V:c:d:f:g:l:n:o:u:w:")) != -1) {
switch (opt) {
case STDPARAM_ARGS:
if (ncp_li_arg(&li, opt, optarg)) {
@ -177,7 +176,7 @@ main(int argc, char *argv[]) {
break;
case 'V':
if (strlen(optarg) > NCP_VOLNAME_LEN)
errx(EX_DATAERR, "volume too long: %s\n", optarg);
errx(EX_DATAERR, "volume too long: %s", optarg);
ncp_str_upper(strcpy(mdata.mounted_vol,optarg));
break;
case 'u': {
@ -227,7 +226,7 @@ main(int argc, char *argv[]) {
else if (strcasecmp(nsp, "NFS") == 0)
mdata.flags |= NWFS_MOUNT_NO_NFS;
else
errx(EX_DATAERR, "Unknown namespace '%s'", nsp);
errx(EX_DATAERR, "unknown namespace '%s'", nsp);
}
break;
};
@ -318,14 +317,14 @@ main(int argc, char *argv[]) {
return 1;
li.opt |= NCP_OPT_WDOG;
/* well, now we can try to login, or use already established connection */
error = ncp_li_login(&li,&connHandle);
error = ncp_li_login(&li, &connHandle);
if (error) {
ncp_error("cannot login to server %s", error, li.server);
exit(1);
}
error = ncp_conn2ref(connHandle, &mdata.connRef);
if (error) {
ncp_error("could not convert handle to refernce.", error);
ncp_error("could not convert handle to reference", error);
ncp_disconnect(connHandle);
exit(1);
}
@ -333,7 +332,7 @@ main(int argc, char *argv[]) {
mdata.version = NWFS_VERSION;
error = mount(NWFS_VFSNAME, mdata.mount_point, mntflags, (void*)&mdata);
if (error) {
ncp_error("mount error: %s", errno);
ncp_error("mount error: %s", error, mdata.mount_point);
ncp_disconnect(connHandle);
exit(1);
}
@ -346,19 +345,14 @@ main(int argc, char *argv[]) {
}
static void
usage(void) {
printf("usage: %s [connection options] [options] \n"
" /server:user/volume[/path] mount-point\n\n", __progname);
printf(
"see ncplogin(1) for details on connection options\n"
" -A host Netware/IP host address\n"
" -u uid uid the mounted files get\n"
" -g gid gid the mounted files get\n"
" -f mode permission the files get\n"
" -d mode permission the dirs get\n"
" -h print this help text\n"
" -v print nwfs version number\n"
"\n"
);
exit(1);
usage(void)
{
fprintf(stderr, "%s\n%s\n%s\n%s\n%s\n",
"usage: mount_nwfs [-Chv] -S server -U user [-connection options]",
" -V volume [-M mode] [-c case] [-d mode] [-f mode]",
" [-g gid] [-l locale] [-n os2] [-u uid] [-w scheme]",
" node",
" mount_nwfs [-options] /server:user/volume[/path] node");
exit (1);
}

View File

@ -8,10 +8,10 @@
.Sh SYNOPSIS
.Nm mount_nwfs
.Op Fl Chv
.Ar -S Ar server
.Ar -U Ar user
.Ar "[connection options]"
.Ar -V Ar volume
.Fl S Ar server
.Fl U Ar user
.Op Fl connection\ options
.Fl V Ar volume
.Op Fl M Ar mode
.Op Fl c Ar case
.Op Fl d Ar mode
@ -24,12 +24,12 @@
.Ar node
.Nm mount_nwfs
.Op Fl options
.Ar /server:user/volume/path
.Ar /server:user/volume[/path]
.Ar node
.Sh DESCRIPTION
The
.Nm
command allow to mount volume from a NetWare server. It may use either
command allows to mount volume from a NetWare server. It may use either
existing connection or create new: if no usable connection was found
it will try to establish a new one. Connection has count of references to it,
so when last mount will be dismounted connection will be closed. It is
@ -50,16 +50,20 @@ command line arguments (the
.Fl U
and
.Fl V
options aren't used in this case). This allows use of fstab file (see EXAMPLES below).
options aren't used in this case). This allows use of
.Xr fstab 5
file (see
.Sx EXAMPLES
below).
.Pp
The options are:
.Bl -tag -width indent
.It Fl S Ar server
name of NetWare server to connect. For native IP you will need also
Name of NetWare server to connect. For native IP you will need also
.Fl A
option.
.It Fl U Ar user
name of user used in login sequence.
Name of user used in login sequence.
.It Fl "[connection options]"
See
.Xr ncplogin 1
@ -71,7 +75,7 @@ before
.It Ar node
Path to mount volume.
.It Fl c Ar case
Selects a
Select a
.Ar case
option which affects on name representation.
.Ar Case
@ -96,46 +100,49 @@ u All existing file names converted to upper case.
U Same as 'u' but file system tries to be case
insensitive. May not work well.
.Ed
.It Fl f Ar mode, Fl d Ar mode
specifies permissions that should be assigned to files and directories.
.It Fl f Ar mode , Fl d Ar mode
Specify permissions that should be assigned to files and directories.
The values must be specified as octal numbers. Default value for the file mode
taken from mount point, default value for the dir mode adds execute permission
where the file mode gives read permission.
is taken from mount point, default value for the dir mode adds execute
permission where the file mode gives read permission.
Note that these permissions can differ from the rights granted by NetWare
server.
.It Fl n Ar namespace
don't use
Don't use
.Ar namespace .
Currently only
.Ar OS2
can be here.
.It Fl v
prints version number.
.It Fl u Ar uid, Fl g Ar gid
Print version number.
.It Fl u Ar uid , Fl g Ar gid
User id and group id assigned to files. The default is owner and group id from
directory where volume is mounted.
.It Fl l Ar locale
Sets the locale for case conversion. By default
Set the locale for case conversion. By default
.Nm
tries to use an environment variable
.Ar LC_* .
.Ev LC_* .
.It Fl w Ar scheme
Selects a
Select a
.Ar scheme
used to convert file names between NetWare and FreeBSD. Currently only
used to convert file names between NetWare and
.Bx Free .
Currently only
.Ar koi2cp866
and
.Ar asis
can be here. Please note, that scheme should be enabled at compile
time in config.mk file.
time in
.Pa config.mk
file.
.It Fl M Ar mode
See
.Xr ncplogin 1
for details. If this option is omitted, connection permissions
assumed the same as directory mode (
.Ar -d )
option.
assumed the same as directory mode
.Pf ( Fl d Ns ) option.
.El
.Sh FILES
.Bl -tag -width /var/log/wtmp -compact
@ -143,19 +150,19 @@ option.
keeps static parameters for connections and other information. See
.Pa /usr/share/examples/nwclient/dot.nwfsrc
for details.
.El
.Sh NOTES
Before any NCP connection can be established kernel must be configured
for IPX support, IPXrouted and KLD nwfs.ko should be loaded.
.Sh EXAMPLES
Next examples illustrates how to connect to NetWare server
.Ar nwserv
.Em nwserv
as user
.Ar GUEST
.Em GUEST
and mount volumes
.Ar SYS
.Em SYS
and
.Ar VOL1 :
.Em VOL1 :
.Bd -literal -offset indent
mount_nwfs -S nwserv -U guest -V sys /nw/s1/sys
mount_nwfs /nwserv:guest/sys /nw/s1/sys
@ -166,7 +173,9 @@ mount -t nwfs /nwserv:boris/sys/home/boris /home/boris/nw/home
The last example mounts only subdirectory on a volume and equivalent
to NetWare 'map root' command.
.Pp
It is possible to use fstab for nwfs mounts:
It is possible to use
.Xr fstab 5
for nwfs mounts:
.Bd -literal -offset indent
/nwserv:guest/sys /nw/s1/sys nwfs rw,noauto 0 0
/nwserv:guest/vol1 /nw/s1/vol2 nwfs rw,noauto 0 0
@ -176,17 +185,23 @@ It is possible to use fstab for nwfs mounts:
to number a few
.Sh CREDITS
In development of NetWare client for FreeBSD, the following sources were used:
In development of NetWare client for
.Bx Free ,
the following sources were used:
.Pp
Documentation from NetWare NDK.
.Pp
ncpfs for Linux - written by Volker Lendecke (lendecke@math.uni-goettingen.de).
Ncpfs for Linux - written by
.An Volker Lendecke Aq lendecke@math.uni-goettingen.de .
He granted me permission to publish parts of his code under BSD-style license,
.Pp
"Interrupt List" from Ralf Brown,
"Interrupt List" from
.An Ralf Brown ,
.Pp
Many files from /sys directory.
Many files from
.Pa /sys
directory.
.Sh AUTHOR
.Sh AUTHORS
.An Boris Popov Aq bp@butya.kz ,
.Aq rbp@chat.ru

View File

@ -53,7 +53,6 @@
#define NWFS_VFSNAME "nwfs"
extern char *__progname;
static char mount_point[MAXPATHLEN + 1];
static void usage(void);
static int parsercfile(struct ncp_conn_loginfo *li, struct nwfs_args *mdata);
@ -134,7 +133,7 @@ main(int argc, char *argv[]) {
while (*p != '/' && *p != 0) *p1++ = *p++;
*p1 = 0;
if (strlen(tmp) > NCP_VOLNAME_LEN) {
warnx("volume name too long: %s\n", tmp);
warnx("volume name too long: %s", tmp);
break;
}
ncp_str_upper(strcpy(mdata.mounted_vol,tmp));
@ -160,7 +159,7 @@ main(int argc, char *argv[]) {
} while(0);
if (error)
errx(EX_DATAERR,
"an error occured while parsing '%s'",
"an error occurred while parsing '%s'",
argv[argc - 2]);
}
if (ncp_li_readrc(&li)) return 1;
@ -168,7 +167,7 @@ main(int argc, char *argv[]) {
parsercfile(&li,&mdata);
rc_close(ncp_rc);
}
while ((opt = getopt(argc, argv, STDPARAM_OPT"V:c:d:f:g:l:n:o:u:w:")) != EOF) {
while ((opt = getopt(argc, argv, STDPARAM_OPT"V:c:d:f:g:l:n:o:u:w:")) != -1) {
switch (opt) {
case STDPARAM_ARGS:
if (ncp_li_arg(&li, opt, optarg)) {
@ -177,7 +176,7 @@ main(int argc, char *argv[]) {
break;
case 'V':
if (strlen(optarg) > NCP_VOLNAME_LEN)
errx(EX_DATAERR, "volume too long: %s\n", optarg);
errx(EX_DATAERR, "volume too long: %s", optarg);
ncp_str_upper(strcpy(mdata.mounted_vol,optarg));
break;
case 'u': {
@ -227,7 +226,7 @@ main(int argc, char *argv[]) {
else if (strcasecmp(nsp, "NFS") == 0)
mdata.flags |= NWFS_MOUNT_NO_NFS;
else
errx(EX_DATAERR, "Unknown namespace '%s'", nsp);
errx(EX_DATAERR, "unknown namespace '%s'", nsp);
}
break;
};
@ -318,14 +317,14 @@ main(int argc, char *argv[]) {
return 1;
li.opt |= NCP_OPT_WDOG;
/* well, now we can try to login, or use already established connection */
error = ncp_li_login(&li,&connHandle);
error = ncp_li_login(&li, &connHandle);
if (error) {
ncp_error("cannot login to server %s", error, li.server);
exit(1);
}
error = ncp_conn2ref(connHandle, &mdata.connRef);
if (error) {
ncp_error("could not convert handle to refernce.", error);
ncp_error("could not convert handle to reference", error);
ncp_disconnect(connHandle);
exit(1);
}
@ -333,7 +332,7 @@ main(int argc, char *argv[]) {
mdata.version = NWFS_VERSION;
error = mount(NWFS_VFSNAME, mdata.mount_point, mntflags, (void*)&mdata);
if (error) {
ncp_error("mount error: %s", errno);
ncp_error("mount error: %s", error, mdata.mount_point);
ncp_disconnect(connHandle);
exit(1);
}
@ -346,19 +345,14 @@ main(int argc, char *argv[]) {
}
static void
usage(void) {
printf("usage: %s [connection options] [options] \n"
" /server:user/volume[/path] mount-point\n\n", __progname);
printf(
"see ncplogin(1) for details on connection options\n"
" -A host Netware/IP host address\n"
" -u uid uid the mounted files get\n"
" -g gid gid the mounted files get\n"
" -f mode permission the files get\n"
" -d mode permission the dirs get\n"
" -h print this help text\n"
" -v print nwfs version number\n"
"\n"
);
exit(1);
usage(void)
{
fprintf(stderr, "%s\n%s\n%s\n%s\n%s\n",
"usage: mount_nwfs [-Chv] -S server -U user [-connection options]",
" -V volume [-M mode] [-c case] [-d mode] [-f mode]",
" [-g gid] [-l locale] [-n os2] [-u uid] [-w scheme]",
" node",
" mount_nwfs [-options] /server:user/volume[/path] node");
exit (1);
}