[ 
https://issues.apache.org/jira/browse/HADOOP-13883?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15741523#comment-15741523
 ] 

Vinayakumar B commented on HADOOP-13883:
----------------------------------------

{code} `-fs <default filesystem URL to use>` | Specify default filesystem URL 
to use. Overrides 'fs.defaultFS' property from configurations. |{code}
Actually, earlier message {{local|namenode:port}} was not wrong. But it didnt 
mention explicitly about supporting other filesystems using full url. In-fact 
'local' is shortcut for 'file:///'  and 'namenode:port' is shortcut for 
'hdfs://namenode:port'.  see FileSystem#fixName() as below.
{code}  /** Update old-format filesystem names, for back-compatibility.  This 
should
   * eventually be replaced with a checkName() method that throws an exception
   * for old-format names.
   */
  private static String fixName(String name) {
    // convert old-format name to new-format name
    if (name.equals("local")) {         // "local" is now "file:///".
      LOGGER.warn("\"local\" is a deprecated filesystem name."
               +" Use \"file:///\" instead.");
      name = "file:///";
    } else if (name.indexOf('/')==-1) {   // unqualified is "hdfs://"
      LOGGER.warn("\""+name+"\" is a deprecated filesystem name."
               +" Use \"hdfs://"+name+"/\" instead.");
      name = "hdfs://"+name;
    }
    return name;
  }{code}

So, Now description can be updated to mention about acceptance of {{local}} and 
{{namenode:port}} also instead of {{file:///}} and {{hdfs://namenode:port}}

hope I am clear now.

> Add description of -fs option in generic command usage
> ------------------------------------------------------
>
>                 Key: HADOOP-13883
>                 URL: https://issues.apache.org/jira/browse/HADOOP-13883
>             Project: Hadoop Common
>          Issue Type: Bug
>          Components: documentation
>            Reporter: Yiqun Lin
>            Assignee: Yiqun Lin
>            Priority: Minor
>             Fix For: 2.8.0, 3.0.0-alpha2
>
>         Attachments: HADOOP-13883.001.patch, HADOOP-13883.addendum001.patch, 
> HADOOP-13883.addendum002.patch
>
>
> Currently the description of option '-fs' is missing in generic command  
> usage in documentation {{CommandManual.md}}. And the users won't know to use 
> this option, while this option already makes sense to {{hdfs dfsadmin}}, 
> {{hdfs fsck}}, etc.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to