Project

General

Profile

Bug #8432

zpool(1M) and zfs(1M) need to better describe allowed characters in dataset names

Added by Yuri Pankov about 3 years ago.

Status:
New
Priority:
Normal
Assignee:
-
Category:
manpage - manual pages
Start date:
2017-06-27
Due date:
% Done:

0%

Estimated time:
Difficulty:
Bite-size
Tags:
Gerrit CR:

Description

currently, zpool(1M) has the following:

             The pool name must begin with a 
             letter, and can only contain alphanumeric characters as well as
             underscore ("_"), dash ("-"), and period (".").

and zfs(1M) doesn't say anything about dataset names at all.

The problem with the description is that set of characters that can be described as alphanumeric depends on the locale, while in reality we only allow [a-zA-Z], so we should either say ASCII alphanumeric characters, or a-zA-Z.

See http://src.illumos.org/source/xref/illumos-gate/usr/src/common/zfs/zfs_namecheck.c#53 for reference.

Also available in: Atom PDF